Payin Order - Cryptocurrency
Create Crypto Payin Order
Content-Type: application/json
Request Parameter Description#
| Field Name | Type | Description | Required | Example |
|---|
title | String | Order title | No | Payment Order |
order_no | String | Merchant order number (Max 64 characters, must be unique) | Yes | P120251222027 |
amount | BigDecimal | Amount | Yes | 1000 |
currency | String | Payment currency | Yes | USDT |
payment_method | String | Payment method code (see payment method list) | Yes | USDT_ERC20 |
callback_url | String | Full callback notification URL | Yes | https://xxx/xxx |
return_url | String | Redirect URL after payment completion | Yes | https://xxx/xxx |
return_type | String | Result return method. PLATFORM: Platform checkout page URL, CUSTOM: Custom checkout page data (qr_code), Default: PLATFORM | No | CUSTOM |
user_ip | String | User IP | Yes | 127.0.0.1 |
expire_seconds | int | Order expiration time, in seconds | No | 3600 |
| payer | object | Payer user information | Yes | |
user_id | String | Unique user identifier (account or ID) | Yes | test001 |
Response Parameter Description#
| Field Name | Type | Description |
|---|
code | integer | Success response code, see error codes for other exceptions |
msg | String | Description |
| data | object | |
trade_no | String | Platform transaction number |
order_no | String | Merchant order number |
status | String | Current pay-in order status (please check status code description) |
message | String | Response description |
amount | String | Order amount |
due_pay_amount | number | Amount due |
currency | String | Order currency |
fee | String | Transaction fee |
| details | object | |
redirect_url | String | Checkout page URL |
qr_code | String | QR code |
Order Successful Response#
Response when return_type is CUSTOM#
Response Failed#
Modified at 2026-06-01 11:49:56