Withdraw Callback

Merchant system should implement API to receive callback from FTIPH. The FTIPH will send request to the callback_url given in withdraw request.

CAUTION

Please make sure the callback_url you provided in payment request are valid and allow domain name of FTIPH to pass your firewall. Or it might cause transactions unsynchronizable.

Request

This request is sent from FTIPH to merchant system when the transaction status is changed.

HTTP Request Method: POST \ Content-Type: application/json

Note

✅ Required ⭕ Optional ❌ Not used

Param	Type	Required	Sign	Description
user_id	String	✅	✅	Merchant identification
order_id	String	✅	✅	Withdraw order Id of merchant system. The order id should be unique.
transaction_id	String	✅	✅	FTIPH transaction id
channel	String	✅	✅	Please refer to Support Channel
submit_currency	String	✅	✅	Submit currency
submit_amount	Float	✅	✅	Submit amount (Support up to 6 decimal places)
accept_currency	String	✅	✅	The currency real paid
accept_amount	Float	✅	✅	Paid amount of accept currency (Support up to 6 decimal places)
exchange_rate	Float	✅	✅	Exchange rate
status	String	✅	✅	0000 = Waiting 1000 = Processing 2000 = Success 3000 = Failed 4000 = Error 5000 = Expired (It may be successful later.)
timestamp	Integer	✅	✅	Transaction last update timestamp (10 digits)
error_message	String	⭕	❌	Error message
reference_number	String	⭕	❌	GCASH transaction id or QRPH Invoice number
details_url	String	⭕	❌	The webpage which to show withdraw details.Link valid for 10 minutes.
sign	String	✅	❌	Signature string. Please refer to Data Signature and Verification

Response

Please using Content-Type: text/plain return the string SUCCESS when callback is received and the signature is verified. If there are problems such as signature verification failure, please return the string FAILED and both parties will clarify the problem.