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
Request URL
  • /v1/vexora/disbursements
Request Method
  • Method: POST
  • Content-Type: application/json
header Required Type Description
merchantNo yes String no
Request Body Parameters
Parameter name Required Type Description
sign yes String Except for sign, the remaining fields are sorted by first letter to form key1=value1key2=value2, and app secrect is used as salt for md5 encryption. The sign is finally lowercase.
timestamp yes String Timestamp๏ผˆ1715941383720๏ผ‰
tradeNo yes String Transaction number (unique (recommended year month day hour minute second + random number))
amount Yes String Payment amount (integer only, unit: yuan, minimum value: 100)
bankCode Yes String Beneficiary bank code: ๏ผˆKBZPAYใ€WAVEPAY๏ผ‰
bankNumber Yes String Beneficiary bank account number
name Yes String Beneficiary name (must be the actual/legal name)
notifyUrl Yes String Asynchronous callback URL
remark No String Remarks (this field will be returned asโ€‘is)
Request Parameter Example
{
  "amount": "100.00",
  "bankCode": "KBZPAY",
  "bankNumber": "3560123456789012",
  "name": "Ko Min Thu",
  "tradeNo": "VX20260331004567",
  "notifyUrl": "https://merchant-api.com/payment/vexora/payout/notify",
  "sign": "e10adc3949ba59abbe56e057f20f883e",
  "timestamp": "1719876543210"
}
Response Results
Parameter name Required Type Description
msg yes String Request result (when success is returned, it only means that the request for this time is successful and cannot be used for merchant-side logical judgment)
code yes String Request response code (when 0000 is returned, it only means that the request for this time is successful, and cannot be used for merchant-side logical judgment). For specific status/error codes, please check the status/error code directory
timestamp yes String Transaction timestamp
success yes String Transaction result
data yes Object Return Object
data.tradeNo yes String Merchant transaction number
data.platFormTradeNo yes String vexora transaction number, unique
data.status yes String Transaction results,Merchants can process subsequent workflows based on the returned status in the transaction result. For details, please refer to the status code reference table.
data.message yes String Error description
data.remark yes String remark
Successful Returned Example
{
  "msg": "success",
  "code": "0000",
  "timestamp": 1719876543210,
  "success": true,
  "data": {
    "tradeNo": "VX20260331004567",
    "platFormTradeNo": "vx8f3k29d0qplm7x2",
    "status": "0015",
    "message": "Processing",
    "remark": "collection_vx_04567"
  }
}