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

Account Type Description

accountType	Description
CVU	Wallet Virtual Account
CBU	Bank Account

ID Type Description

idType	Description
DNI	DNI (National Identity Document), numeric only, 7 or 8 digits
CUIL	CUIL (Labor Identification Code), 11 digits, fixed format XX-XXXXXXXX-X
CUIT	CUIT (Tax Identification Code), 11 digits, fixed format XX-XXXXXXXX-X
PA	Passport, up to 15 digits

Request URL

• /v1/vexora/disbursements

Request Method

• Method: POST
• Content-Type: application/json

Header

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)
idType	Yes	String	Beneficiary ID type. Refer to the ID Type Description table.
idCardNumber	Yes	String	Beneficiary ID card number. The value must match the selected idType.
accountType	Yes	String	Beneficiary account type. Refer to the Account Type Description table.
accountNo	Yes	String	Beneficiary account number. Use CVU for wallet virtual accounts or CBU for bank accounts.
firstname	Yes	String	Beneficiary's first name.
lastname	Yes	String	Beneficiary's last name.
email	Yes	String	Beneficiary's email address
mobile	Yes	String	Beneficiary's mobile number.
notifyUrl	Yes	String	Asynchronous callback URL
remark	No	String	Remarks (this field will be returned as‑is)

Request Parameter Example

{
  "amount": "100",
  "idType": "DNI",
  "idCardNumber": "12345678",
  "accountType": "CVU",
  "accountNo": "0000003100010000000001",
  "firstname": "Juan",
  "lastname": "Perez",
  "email": "juan.perez@example.com",
  "mobile": "1123456789",
  "tradeNo": "VX20260331008901",
  "notifyUrl": "https://api.merchant.com/vexora/disbursement/notify",
  "sign": "7c6a180b36896a0a8c02787eeafb0e4c",
  "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": "VX20260331011223",
    "platFormTradeNo": "vx4m8k2d9pl0q7f1a",
    "status": "0015",
    "message": "Processing",
    "remark": "collection_vx_11223"
  }
}