跳转到内容

金额与代币

字段类型说明
amount字符串代币本位十进制,如 USDT "10.50"(6 位小数)
amountRaw字符串最小单位整数,如 "10500000"

创建订单时的 amount 与到账 Webhook 中的 amount / amountRaw 均遵循上述规则。

tokenSymbol(如 USDT)须与本环境已启用的代币一致,由平台配置合约地址与白名单。不支持的符号将返回 400 BAD_REQUEST

响应中的 tokenContract 为当前环境该代币的合约地址;paymentNetwork 表示收款链族(首期多为 TRC20,后续将支持更多网络)。

status含义
PENDING待付款
PARTIAL部分到账(低于应付金额)
PAID已付清
EXPIRED已过期
CANCELED已取消

Webhook payment.paid 在订单达到 PAID 且满足确认数策略后发送;部分到账场景请结合轮询 GET /v1/payments/:id 与业务规则处理。