Create a payin order
请求地址
| method | url |
|---|---|
| POST | /api/pay/payment/create/v1 |
Header
| Header Field | Description |
|---|---|
| timestamp | Request timestamp |
| nonce | Random value |
| country | BP |
| app_code | Application ID |
Request Parameters
| Field | Type | Required | Max Length | Description |
|---|---|---|---|---|
| merchantOrderNo | String | yes | 32 | Merchant order number |
| amount | String | yes | 20 | Payment collection amount |
| callbackUrl | String | no | 200 | Callback URL for collection result (if not provided, merchant configuration will be used) |
| sign | String | yes | Signature |
{ "amount": "1000", "sign": "YOUR_SIGN", "callbackUrl": "https://www.callbackexample.com", "merchantOrderNo": "OrderNoExample"}Response Parameters
| Field | Type | Required | Length | Description |
|---|---|---|---|---|
| merchantOrderNo | String | yes | 32 | Merchant order number |
| tradeNo | String | yes | 32 | Platform order number |
| amount | String | yes | 32 | Transaction amount |
| paymentType | Int | yes | 10 | Payment method (e.g., 10001) |
| paymentInfo | String | yes | 32 | Main payment information, such as a payment URL or reference |
| additionalInfo | JSONObject | no | Additional information: address and currency info | |
| status | Int | yes | Order status: 1 = created successfully, 3 = failed | |
| errorMsg | String | no | Error 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 }}