Create Withdraw (Philippines)

Create a Philippinesese Dong (PHP) withdrawal order interface.

Request Information

• Request URL: /gateway/api/v2/payouts
• Request Method: POST
• Content-Type: application/json;charset=utf-8

Request Parameters

Parameter	Required	Type	Description
platform_id	Yes	String(6)	Merchant ID
service_id	Yes	String(7)	Service ID
payout_cl_id	Yes	String(64)	Merchant Order Number
amount	Yes	Integer(10)	Amount (cents)
notify_url	No	String(256)	Transaction result notification URL
bank_name	Yes	String(16)	Philippines Bank List
name	Yes	String(16)	Payee account name
number	Yes	String(32)	Payee account number
currency	Yes	String(3)	Fixed value: vnd
request_time	Yes	Integer(10)	Request time (seconds)
sign	Yes	String(32)	Order Signature

Request Example

{
  "amount": "50000",
  "bank_name": "ACB",
  "name": "test_name",
  "notify_url": "https://xxx.xx/notification",
  "number": "4088748280272397",
  "payout_cl_id": "DEVPOT00143538",
  "platform_id": "PF0002",
  "request_time": "1595504997",
  "service_id": "SVC0004",
  "sign": "8ac38fb87c2bcce4cf36627d4f8aa747"
}

Response Example

Success Response

{
  "error_code": "0000",
  "data": {
    "payout_id": "POT00000001"
  }
}

Error Response Example

{
  "error_code": "0004",
  "error_msg": "Signature verification failed!"
}

Response Parameters

Parameter	Type	Description
error_code	String	Error code
error_msg	String	Error message (returned when error_code is not "0000")
payout_id	String	Platform order number

Notes

IMPORTANT NOTICE

Due to force majeure factors such as network fluctuations, excessive concurrency, attacks, etc., if you encounter timeout, HTTP 500 errors, blank response, or network delays when calling the withdrawal interface, please use the order query interface status as the basis, or contact operations personnel and provide the merchant order number for manual inquiry. Operations personnel will manually confirm whether the withdrawal order has failed. The platform is not responsible for any losses caused by rejecting withdrawal orders without manual confirmation from operations personnel!

• Merchant ID is a unique identifier assigned by the system. If you haven't obtained one, please contact system personnel
• Service ID options:
  • SVC0004 (Bank Card Withdrawal)
  • SVC0018 (MOMO Withdrawal)
  • SVC0047 (ZALO Withdrawal)
• When using SVC0018 or SVC0047, please fill bank_name with "none"
• Transaction amount unit is Philippinesese Dong (cents), please multiply by 100. For example, to withdraw 10000.00, pass the value 1000000
• Request time uses Unix timestamp in seconds
• Returning "0000" only means the interface call was successful, not the transaction status. Please call the query interface to confirm the result
• If you do not receive a Server response under any circumstances (e.g. 5xx HttpStatus...), you must call the query interface or wait for the callback. Do not directly consider the order as failed