Disbursement¶
Malaysia APIs
Introduction 路 Response Code 路 Checkout 路 Disbursement 路 Check Deposit Status 路 Check Disbursement Status 路 Disbursement Bank Codes 路 Deposit WayCode 路 Check Balance 路 Webhook
Tip
Payout API is used to initiate transfer requests to e-wallets or bank accounts.
- All requests are
Postrequests, and the data format isjson
Brief Description¶
- Use this API to create a Malaysia disbursement transaction to a bank account or supported wallet.
Request URL¶
/v1/vexora/disbursements
Request Method¶
- Method: POST
- Content-Type: application/json
Header¶
| Header | Required | Type | Description |
|---|---|---|---|
| merchantNo | Yes | String | Merchant number assigned by Vexora. |
Request Body Parameters¶
| Parameter | Required | Type | Description |
|---|---|---|---|
| sign | Yes | String | Compose the remaining fields (excluding sign) in alphabetical order as key1=value1key2=value2, use the app secret as the salt for MD5 encryption, and the final sign should be in lowercase letters. |
| timestamp | Yes | integer | Timestamp (e.g., 1715941383720) |
| tradeNo | Yes | String | Merchant transaction number. This value must be unique for each request. |
| amount | Yes | String | Transaction amount, supports up to 2 decimal places, unit: Malaysian Ringgit (MYR). |
| bankCode | yes | String | Beneficiary bank code. See the Disbursement Bank Codes appendix. |
| accountNo | yes | String | Bank account number |
| firstname | yes | String | Beneficiary's first name |
| lastname | yes | String | Beneficiary's last name |
| mobile | yes | String | Beneficiary's mobile number |
| yes | String | Beneficiary's email address | |
| notifyUrl | Yes | String | Webhook URL for asynchronous transaction notifications. |
| remark | No | String | Merchant remark. This value is returned as submitted when available. |
Request Parameter Example¶
{
"sign": "29604bf1662fd6acddfbd33eaee0179f",
"timestamp": 1748248240605,
"tradeNo": "MYPO202605140001",
"amount": "500.00",
"bankCode": "0001",
"accountNo": "123456789012",
"mobile": "01234567890",
"email": "nur.aisyah@example.com",
"firstname": "Nur",
"lastname": "Aisyah",
"notifyUrl": "https://merchant.example.com/vexora/payout-notify",
"remark": "Payout MYPO202605140001"
}
Response Result¶
| Parameter | Required | Type | Description |
|---|---|---|---|
| msg | Yes | String | API request message. A value such as success only indicates that the API request was processed. |
| code | Yes | String | API request code. 0000 only indicates that the API request was successful. Use data.status to determine the transaction result. |
| timestamp | Yes | String | Transaction timestamp |
| success | Yes | String | Transaction result |
| data | Yes | Object | Returned object |
| data.tradeNo | Yes | String | Merchant transaction number returned |
| data.platFormTradeNo | Yes | String | Unique platform order number |
| data.status | Yes | String | Transaction status. Use this value to determine the final business result. For details, refer to the response code section. |
| data.message | Yes | String | Error description |
| data.remark | Yes | String | Merchant remark returned as submitted. |