Skip to content

Checkout

Tip

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

Visa / Mastercard

Request URL
  • /v1/vexora/checkout
Request Method
  • Method: POST
  • Content-Type: application/json
Parameter Required Type Description
merchantNo Yes String Merchant number
Request Body Parameters
Name Required Type Description
sign Yes String Use all fields except sign, sort them alphabetically, and concatenate as key1=value1key2=value2.... Then use the app secret as a salt for MD5 encryption. The sign should be in lowercase.
timestamp Yes long Timestamp of the transaction.
amount Yes String Transaction amount (supports up to two decimal places)
mobile Yes String Beneficiary's mobile number (supports country code + local mobile number)
email Yes String Email address (used to notify the user by email after the transaction is completed)
userId Yes String Merchant user ID (can be a fixed value)
currency Yes String Currency (fixed as USD)
notifyUrl Yes String Asynchronous callback URL
returnUrl Yes String URL to redirect the customer after successful authorization
remark No String Remarks (this field will be returned as‑is)
Request Example
{
        "sign": "f53ee692f15d0329a1461373b67ff25a",
        "timestamp": "1724142041682",
        "tradeNo": "00000007",
        "amount": "300.00",
        "mobile": "918234567890",
        "email": "123@qq.com",
        "userId":"Test",
        "currency":"USD",
        "notifyUrl": "https://google.com",
        "returnUrl": "http://abc.com/callback_page",
        "remark": "000000"
}
Response Parameters
Parameter Name Required Type Description
msg Yes String Request result (only indicates the success of the current request, not for merchant-side logic).
code Yes String Response code (only indicates the success of the current request, not for merchant-side logic). For specific error codes, 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 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.desc Yes String Error description.
data.remark Yes String Request content returned (as is).
data.paymentUrl Yes String Payment link, i.e., cashier link.
Successful Response Example
{
    "msg": "success",
    "code": "0000",
    "timestamp": 1729153481590,
    "success": true,
    "data": {
        "platFormTradeNo": "jfr6npomvg2qaa49",
        "status": "0015",
        "desc": "CREATED",
        "remark": "test",
        "paymentUrl":"https://ccutest.dj70000.com/?data=0ae849a17a57ad6fa6edfa42c208b042ae54e83ef3997c36271eddd0434c24f54a6e71a8b536da873167746c263f47772849fffc0a9829bc0f5ba99a24719c548f75a78b1205574c15aaca8fd3de67e97963afc5d9fcfa4ef559f59326bd91d0e1bc0fb9600a7bd893c688b301928d7dd69d79d0d4e3489f5711658c3302810b37520b20ecd22816e10a4d3b1cbc1754b0417a0f446462bfa357595a048430e7489fcba303d0ff5f6da6b06eb53c7cf63967b3a36686bffd757db669f7a293dffc97661c17ae21bec4386f321cd6953ee222edd0afcc64f2af4a0b00ad67738345ba446e04950b12a1b560973498eecdf1c2d406340d9941c880482509fccf21dbffb19164a47d2d089bbe75548af19eaaba93b9e70f780ef7ba50c081e453f5"
    }
}