POST /api/orders/create-pay-link
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
apikey | string | 是 | 商户的 APIKey |
initiator | string | 是 | 用户唯一标识 |
amount | float | 是 | 充值金额(USDT) |
order_no | string | 是 | 商户自定义订单号 |
lang | string | 否 | 语言标识(默认 zh,可为 en) |
callback_url | string | 是 | 支付成功后回调地址 |
{ "apikey": "your-api-key", "initiator": "user001", "amount": 99.88, "order_no": "QO-20250425-ABC123", "lang": "zh", "callback_url": "https://yourdomain.com/callback" }
{ "code": 1, "message": "生成订单成功", "data": { "order_id": "QO-20250425-ABC123", "pay_url": "https://yourdomain.com/quick-pay?order_id=QO-20250425-ABC123&lang=zh&v2=1", "amount": 99.88, "address": "TLPzxxxxx", "expire_at": "2025-04-25 15:10:00" } }
order_sn:系统生成的唯一订单号
pay_url:支付页面链接地址,可生成二维码
amount:支付金额
address:充值 USDT 地址
expire_at:支付页面有效截止时间
此接口只负责创建订单和返回支付链接,不执行链上支付
支付链接有效期为 10 分钟,超时将自动失效
回调地址建议使用 HTTPS,系统将在到账后以 POST 通知
无论是哪种类型的订单,当成功到账后,系统将向 callback
地址发送如下 POST 请求:
{ "address": "Txxx", "amount": "100.29", "txid": "txid哈希", "timestamp": "Unix时间戳", "sign": "签名字符串"}
签名为 MD5(address=value&amount=value&txid=value×tamp=value
+ secret)
若 HTTP 状态码为 200,则视为成功
其余状态视为失败,记录日志并尝试重发(由后台触发)