Withdraw Request

Request

API URL: /merchant/v2/{GUID}/withdraw

Note

{GUID} Obtained from the merchant backend (API Docking -> GUID)

✅ Required ⭕ Optional ❌ Not used

Header	Content	Description
Content-Type	text/plain
X-Transaction-Signature	{transaction_signature}	Please refer to Transaction Signature

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.
amount	String	✅	✅	Transaction amount (Support up to 6 decimal places)
currency	String	✅	✅	Please refer to Support Channel
channel	String	✅	✅	Please refer to Support Channel
timestamp	Integer	✅	✅	Request timestamp (10 digits), If the time difference is allowed to be 5 seconds, it will fail.
details	Details	⭕	❌	Details object depends on channel
callback_url	URL	⭕	❌	The url to receive callback request from PTS when transaction complete.
remark	String	⭕	❌	Remark
sign	String	✅	❌	Signature string. Please refer to Data Signature and Verification

Details Object

MAYAGCASHQRPHChannel

Param	Type	Description
channel_subject	String	Channel subject. Please refer to Support Channel
account_number	String	Payee's Account number. (Numbers 10~20)
email	String	Validate email format.
phone	String	1. The phone number starts with "09" and consists of 11 digits, for example: 09123456789. 2. The phone number starts with "9" and consists of 10 digits, for example: 9123456789.
name	String	Payee's Name. 1. Must be within 30 characters and cannot include special characters, such as: \"/*!@#...\". Values exceeding this limit will be truncated. 2. The format should be: firstname middlename (optional) lastname. If lastname is missing, the system will default to "NA".
address	String	Payee's Address.

Response

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
sign	String	✅	❌	Signature string. Please refer to Data Signature and Verification

Response Example

{
  "code": "1000",
  "message": "Accepted",
  "data": {
    "user_id": "28",
    "order_id": "202407311241124",
    "transaction_id": "W282024073113412453",
    "channel": "MAYA",
    "submit_currency": "PHP",
    "submit_amount": 20000,
    "accept_currency": "PHP",
    "accept_amount": 20000,
    "exchange_rate": 1,
    "sign": "daseqw3t6uhghfsdeD8t2RyNzL..."
  }
}