Skip to content

Disbursement

Tip

Payout API is used to initiate transfer requests to e-wallets or bank accounts.

  • All requests are Post requests, and the data format is json
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 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
email 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.
Success Response Example
{
    "msg": "success",
    "code": "0000",
    "timestamp": 1748248243683,
    "success": true,
    "data": {
        "tradeNo": "MYPO202605140001",
        "platFormTradeNo": "MYPOPLAT202605140001",
        "status": "0015",
        "message": "PAYING",
        "remark": "Payout MYPO202605140001"
    }
}