Skip to content

Create a payin order

请求地址

methodurl
POST/api/pay/payment/create/v1
Header FieldDescription
timestampRequest timestamp
nonceRandom value
countryBP
app_codeApplication ID

Request Parameters

FieldTypeRequiredMax LengthDescription
merchantOrderNoStringyes32Merchant order number
amountStringyes20Payment collection amount
callbackUrlStringno200Callback URL for collection result (if not provided, merchant configuration will be used)
signStringyesSignature
Sample Request
{
"amount": "1000",
"sign": "YOUR_SIGN",
"callbackUrl": "https://www.callbackexample.com",
"merchantOrderNo": "OrderNoExample"
}

Response Parameters

FieldTypeRequiredLengthDescription
merchantOrderNoStringyes32Merchant order number
tradeNoStringyes32Platform order number
amountStringyes32Transaction amount
paymentTypeIntyes10Payment method (e.g., 10001)
paymentInfoStringyes32Main payment information, such as a payment URL or reference
additionalInfoJSONObjectnoAdditional information: address and currency info
statusIntyesOrder status: 1 = created successfully, 3 = failed
errorMsgStringnoError message, returned if the request failed

响应示例

{
"msg": "success",
"traceId": "747bbf80261844ed85b809212aab0d81.85.17422898158610299",
"code": 200,
"data": {
"amount": "1000.00",
"tradeNo": "TS2501010001BP0000000000000000",
"additionalInfo": {
"addresses": [
{
"coin": "usdt_trc20",
"address": "TAX9SYsqbedDyeR6ysS9spx8cXQNC8raR3"
}
]
},
"merchantOrderNo": "OrderNoExample",
"paymentInfo": "https://www.linkExample.com",
"paymentType": 1,
"status": 1
}
}