创建支付链接接口

概述

服务地址：https://api.crossingpay.com
数据格式：JSON

请求方式

    POST /api/orders/create-pay-link

Tip：该接口支持手动回调，入口"首页"->"测试回调"

请求类型
application/json

请求参数

参数名	类型	必填	说明
apikey	string	是	商户的 APIKey
initiator	string	是	商户业务系统的用户唯一标识,可以是UUID、用户昵称等
amount	float	是	充值金额（USDT）
order_no	string	是	商户自定义订单号
lang	string	否	语言标识（默认 zh，可为 en）,其他已支持语言见更多；需要特定语言可以找客服反馈添加
callback_url	string	是	支付成功后回调地址

多语言支持表：印地语（hi）、西班牙语（es）、法语（fr）、阿拉伯语（ar）、孟加拉语（bn）、俄语（ru）、葡萄牙语（pt）、乌尔都语（ur）、印尼语（id）、德语（de）、日语（ja）、马拉地语（mr）、越南语（vi）、泰卢固语（te）、土耳其语（tr）、泰米尔语（ta）、韩语（ko）、意大利语（it）

请求示例

{
    "apikey": "69b1f2fa-xxx-xxx-xxx-063bf080e376",
    "initiator": "xxx",
    "amount": 1.5,
    "order_no": "20250xxx12aa32",
    "lang": "zh",
    "callback_url": "https://www.xx.com/call"
}

返回结果

{
    "code": 200,
    "data": {
        "address": "TEgRLssRNnBNxxxxxXpfP1oQur",
        "amount": 1.5,
        "expire_at": "2025-xx-05 15:46:42",
        "order_id": "202504xxxxx2aa32",
        "pay_url": "  //为确保稳定性，可以在其他配置中获取cname自助解析域名使用 
        "systemOrderID": "202505051536421257"
    },
    "message": "生成订单成功"
}

字段说明

order_sn：系统生成的唯一订单号
pay_url：支付页面链接地址，可生成二维码
amount：支付金额
address：充值 USDT 地址
expire_at：支付页面有效截止时间

注意事项

此接口只负责创建订单和返回支付链接，不执行链上支付
支付链接有效期为 10 分钟，超时将自动失效
回调地址建议使用 HTTPS，系统将在到账后以 POST 通知

回调通知格式

无论是哪种类型的订单，当成功到账后，系统将向 callback 地址发送如下 POST 请求：

请求内容（JSON）

{  "Address": "Txxx",  "Amount": "100.29",  "OrderID": "202505140XXXXXX1259",  "SystemOrderID": "20250514XXXX1015", "Txid": "txid哈希", "Status": 1,   "Timestamp": "Unix时间戳",  "Sign": "签名字符串"}

参数说明

Address:充值或者提现目标地址；

Amount：充值或者提现金额；

OrderID：商户业务系统订单号

SystemOrderID：钱包系统订单号

Txid：合约txid地址

Status：0失败，1成功，2等待中

Sign：请求签名，签名为 MD5(address=value&amount=value&txid=value&timestamp=value + APIKey)

回调响应要求

若 HTTP 状态码为 200，则视为成功
其余状态视为失败，记录日志并尝试重发（由后台触发）

创建收款订单