跨越支付 开发文档

创建收款订单

创建支付链接接口

请求方式


    POST /api/orders/create-pay-link


请求参数

参数名类型必填说明
apikeystring商户的 APIKey
initiatorstring用户唯一标识
amountfloat充值金额(USDT)
order_nostring商户自定义订单号
langstring语言标识(默认 zh,可为 en)
callback_urlstring支付成功后回调地址

请求示例

{
  "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 请求:

请求内容(JSON)

{  "address": "Txxx",  "amount": "100.29",  "txid": "txid哈希",  "timestamp": "Unix时间戳",  "sign": "签名字符串"}

签名为 MD5(address=value&amount=value&txid=value&timestamp=value + secret)

回调响应要求

  • 若 HTTP 状态码为 200,则视为成功

  • 其余状态视为失败,记录日志并尝试重发(由后台触发)