金额与代币
| 字段 | 类型 | 说明 |
|---|---|---|
amount | 字符串 | 代币本位十进制,如 USDT "10.50"(6 位小数) |
amountRaw | 字符串 | 最小单位整数,如 "10500000" |
创建订单时的 amount 与到账 Webhook 中的 amount / amountRaw 均遵循上述规则。
tokenSymbol(如 USDT)须与本环境已启用的代币一致,由平台配置合约地址与白名单。不支持的符号将返回 400 BAD_REQUEST。
响应中的 tokenContract 为当前环境该代币的合约地址;paymentNetwork 表示收款链族(首期多为 TRC20,后续将支持更多网络)。
订单状态与部分到账
Section titled “订单状态与部分到账”| status | 含义 |
|---|---|
PENDING | 待付款 |
PARTIAL | 部分到账(低于应付金额) |
PAID | 已付清 |
EXPIRED | 已过期 |
CANCELED | 已取消 |
Webhook payment.paid 在订单达到 PAID 且满足确认数策略后发送;部分到账场景请结合轮询 GET /v1/payments/:id 与业务规则处理。