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

(This section is intentionally left blank for brevity.)

Request URL
  • /v1/vexora/disbursements
Request Method
  • Method: POST
  • Content-Type: application/json
Header Required Type Description
merchantNo Yes String N/A
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 Uniqueness (recommended format: YYYYMMDDHHMMSS+random number)
amount Yes String Payment amount (ecimals are not recommended)
walletId Yes String Beneficiary Account Number๏ผˆAn 11-digit number starting with 01๏ผ‰
wayCode Yes String BKASHใ€NAGAD
notifyUrl Yes String Asynchronous callback URL
remark No String Remarks, this field will be returned in the callback
Request Parameter Example
{
  "sign": "b39f64dc1586867b1966a569ba06e3a2",
  "timestamp": "1728611780130",
  "tradeNo": "test_00000001",
  "amount": "300",
  "notifyUrl": "https://google.com",
  "wayCode": "BKASH",
  "walletId": "01123456789",
  "remark": "test"

}
Response Result
Parameter Required Type Description
msg Yes String Request result (when "success" is returned, it only indicates the success of this request and cannot be used for merchant-side logical judgment)
code Yes String Request response code (when "0000" is returned, it only indicates the success of this request and cannot be used for merchant-side logical judgment). For specific error codes, please refer to the business error code enumeration.
timestamp Yes String Transaction timestamp
success Yes String Transaction result
data Yes Object Returned object
data.platFormTradeNo Yes String Unique platform order number
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.desc Yes String Error description
data.remark Yes String Remarks
Success Response Example
{
    "msg": "success",
    "code": "0000",
    "timestamp": 1729947461317,
    "success": true,
    "data": {
        "platFormTradeNo": "8rlfud1oh1ruceq7",
        "status": "0100119",
        "desc": "fail"
    }
}