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
• API Documentation for Payout via PIX

Brief Description

Request URL

• /v1/vexora/disbursements

Request Method

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

Header

Header	Required	Type	Description
merchantNo	Yes	String	-

Request Body Parameters

Parameter Name	Required	Type	Description
timestamp	Yes	String	Timestamp (e.g., 1715941383720)
sign	Yes	String	Generate the sign by sorting the body fields by their first letter into key1=value1key2=value2, then use the app secret as salt for MD5 encryption. The final sign should be in lowercase letters.
tradeNo	Yes	String	Unique transaction number (suggested format: YYYYMMDDHHMMSS + random number)
amount	Yes	String	Payment amount
name	Yes	String	Recipient's name
email	Yes	String	Recipient's email
mobile	Yes	String	Recipient's mobile phone number
accountType	Yes	String	PIX key type. Supported values: CPF, CNPJ, EMAIL, PHONE, EVP.
bankNumber	Yes	String	Recipient's PIX key. The value format must match accountType.
idType	Yes	String	Recipient's ID type (CPF/CNPJ)
idCardNumber	Yes	String	Recipient's ID number
notifyUrl	Yes	String	Asynchronous callback URL
remark	Yes	String	Request remark

Request Parameter Example

{
  "timestamp": "1724149702962",
  "tradeNo": "123231222",
  "amount": "300",
  "name": "abc",
  "email": "abc@xx.com",
  "mobile": "123456789",
  "accountType": "CPF",
  "bankNumber": "10094038292",
  "idType": "CPF",
  "idCardNumber": "18171847084",
  "notifyUrl": "xxxxxx",
  "remark": "000000",
  "sign": "bf679a1b1a9bb4951d0694863167608d"
}

Response Result

Parameter Name	Required	Type	Description
msg	Yes	String	Request result (Returning "success" only indicates the request was successful; it should not be used for merchant-side logic)
code	Yes	String	Request response code (Returning "0000" only indicates the request was successful; it should not be used for merchant-side logic)
timestamp	Yes	Long	Server timestamp in milliseconds
success	Yes	Boolean	Whether the API request was processed successfully
data	Yes	Object	Response object
data.platFormTradeNo	Yes	String	vexora transaction number, unique
data.tradeNo	Yes	String	Merchant transaction 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.message	Yes	String	Transaction status description

Successful Response Example

{
    "msg": "success",
    "code": "0000",
    "timestamp": 1719829933893,
    "success": true,
    "data": {
        "platFormTradeNo": "32e936de44164512abe419a9d1b2449a",
        "tradeNo": "123231222",
        "status": "0015",
        "message": "CREDIT_INPROGRESS"
    }
}

---