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/deposits

Request method

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

Way Code

wayCode Description
store convenience store
va Va repayment
header required type description
merchantNo yes String no

Body

parameterName required type description
sign Yes String Except sign, initialise the remaining fields to form key1=value1key2=value2, use app secrect to do salt for md5 encryption, sign ends up being lowercase
timestamp Yes long timestamp (1715941383720)
tradeNo Yes String tradeNo (uniqueness (suggested year, month, day, hour, minute, second + random number) number)
amount Yes String Amount (Decimal not supported)
mobile No String User's mobile phone number
email No String email
payer No String Payer Name
wayCode Yes String collection method code
notifyUrl Yes String asynchronous callback address
returnUrl No String Checkout page jump address, remove the escape character ‘\’, refer to the format https://www.abc.com/ If not passed, jump to the default success page
remark No String Remarks, this field will be brought back as is.

Example of request parameters

{
  "sign": "0be92a962072b1786a01a2cab4891a1d",
  "timestamp": "1728609257212",
  "tradeNo": "test_00000008",
  "amount": "300",
  "mobile": "15745896325",
  "email": "kevin_zhang@163.com",
  "payer": "kevin zhang",
  "notifyUrl": "https://google.com",
  "returnUrl": "http://abc.com/callback_page",
  "remark": "test",
  "wayCode": "va"
}

Response results

parameter name required type description
msg Yes String Request result (when return success only means that the request is successful, can not do the merchant side of the logic judgement)
code Yes String Request Response Code (when the return 0000 only indicates that the request is successful, can not do the merchant side of the logic judgement), the specific error code, please go to the business error code enumeration view
timestamp Yes String trading hours
success Yes String Transaction results
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.desc Yes String misdescription
data.remark Yes String Return content of the request (brought back the way it was)
data.paymentInfo Yes String Payment information

Successful return example

{
    "msg": "success",
    "code": "0000",
    "timestamp": 1728609277476,
    "success": true,
    "data": {
        "tradeNo": "test_00000008",
        "tradeNo": "68o0uwogz7mnzutt",
        "status": "0015",
        "desc": "Create",
        "remark": "test",
        "paymentInfo": "6841800930023213210"
    }
}