Skip to content

Direct Deposit

  • Payment API utilizes JSON data and does not provide a payment page, requiring merchants to create and manage their own payment page.

Tip

  • All requests are Post requests, and the data format is json

Brief description

Request URL

  • /v1/vexora/checkout

Request method

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

Request Parameters

Parameter Required Type Description
sign Yes string Lowercase MD5 signature. See Signature.
timestamp Yes string Request timestamp in milliseconds.
tradeNo Yes string Unique merchant transaction ID; maximum 32 characters.
currency Yes string Only USDT is supported.
amount Yes string Pay-in amount in USDT, with up to two decimal places.
mobile Yes string Payer mobile number, including country code.
username Yes string Payer name.
email Yes string Payer email address.
channelCode Yes string Payment channel; see Deposit WayCode.
wayCode Yes string Payment method; see Deposit WayCode.
subMerchantNo Yes string Sub-merchant number. Obtain it from operations after submitting the sub-merchant information.
notifyUrl Yes string Merchant webhook URL.
returnUrl Yes string URL to which the customer is redirected after authorization.
remark Yes string Optional merchant note returned in the response and webhook.

Example Request

{
  "tradeNo": "00000007",
  "currency": "USDT",
  "amount": "300.00",
  "mobile": "65812345678",
  "username": "Alex Example",
  "email": "customer@example.com",
  "channelCode": "BINANCEPAY",
  "wayCode": "BINANCEPAY",
  "subMerchantNo": "982773727848278231",
  "notifyUrl": "https://merchant.example.com/webhooks/vexora",
  "returnUrl": "https://merchant.example.com/payment/complete",
  "remark": "order-0001",
  "timestamp": "1724142041682",
  "sign": "<lowercase-md5-signature>"
}

Response

Field Type Description
msg string API message. A successful message does not establish the transaction outcome.
code string Top-level API result code. See Response Codes.
timestamp number/string Response timestamp.
success boolean API-level result.
data.tradeNo string Merchant transaction ID.
data.platFormTradeNo string Vexora platform transaction ID.
data.status string Transaction status: 0000 success, 0001 partial success, 0015 processing.
data.message string Transaction status description.
data.remark string Merchant note returned from the request.
data.paymentLink string Customer payment URL.
data.payInfoQr string Raw payment QR information; currently documented for BINANCE_PAY.

Example Response

{
  "msg": "success",
  "code": "0000",
  "timestamp": 1728609277476,
  "success": true,
  "data": {
    "tradeNo": "428c430ce59b47138674c971ff07a711",
    "platFormTradeNo": "c167o1itir0fypid",
    "status": "0015",
    "message": "Paying",
    "remark": "order-0001",
    "paymentLink": "https://merchant.example.com/payment-link",
    "payInfoQr": "https://merchant.example.com/payment-qr.jpg"
  }
}