Create Withdrawal Order (Malaysia)

API for creating Malaysian Ringgit (MYR) withdrawal orders, supporting Malaysian bank transfers.

Request Information

• Request URL: /gateway/api/v2/payouts
• 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, fixed value SVC0004
payout_cl_id	Yes	String(64)	Merchant Order ID
amount	Yes	Integer(10)	Amount (in sen)
notify_url	No	String(256)	Callback URL for transaction results
bank_name	Yes	String(16)	Bank code, the English bank name is also accepted, Bank List
name	Yes	String(64)	Beneficiary name
number	Yes	String(64)	Beneficiary account
currency	Yes	String(3)	Fixed value: myr
request_time	Yes	Integer(10)	Request time (seconds)
sign_type	No	String(16)	Signature type, fixed value HMAC-SHA256
sign	Yes	String(32|64)	Order Signature

Service ID

• SVC0004 Bank Transfer

Response Example

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

Remarks

Important

In case of a timeout or HTTP 500 error, rely on the order query interface for the status; do not treat it as a failed order.

• Transaction amount is in Malaysian Ringgit (sen)
• For bank_name, passing the bank code from the Bank List (e.g. MAYB) is recommended; the English bank name listed there is also accepted (case-insensitive)
• bank_name, name (beneficiary name) and number (beneficiary account) are all required
• Per-transaction limit: 30.00 – 20000.00 MYR
• If the beneficiary details fail validation, the error is returned at creation time and no order is created: 0002 (Invalid request parameters) when bank_name is missing or name / number is empty; 0012 (Bank not found) when bank_name is not in the bank list
• "0000" only means the API call succeeded; call the query interface to confirm the result