收款订单的生命周期
1
订单已创建
您的服务器调用
POST /v1/order/createCollection,传入金额、代币符号和链信息。网关创建一个状态为 INIT 的订单,并返回唯一的充值地址和结账 URL。2
等待支付
订单进入
PENDING 状态。客户在结账页面上看到充值地址和二维码。订单有一个可配置的过期时间。3
检测到交易
区块链扫描器检测到与金额和充值地址匹配的传入交易。状态变更为
PENDING_CONFIRMATION。发送 Webhook(ORDER_PENDING_CONFIRMATION)并附带交易详情。4
已确认
在达到所需的区块确认数(每条链可配置)后,订单状态变更为
SUCCESS。发送 Webhook(ORDER_SUCCESS)。资金现已进入您的网关热钱包。5
已过期或失败
如果在过期时间之前未收到付款,订单状态变为
EXPIRED。如果交易验证失败,则变为 FAILED。XPayLabs 使用哪些订单状态?
收款如何从服务器流向区块链?
PaymentAddress 对象
创建收款时,网关返回一个PaymentAddress 对象:
金额格式
所有金额均为字符串格式的十进制数(例如"100.00")。这避免了 JavaScript 处理大数时常见的浮点精度问题。

