USDT收款系统 - API对接文档

接入必读

1. 接口基础地址：https://your-domain.com/api/gateway

2. 数据传输格式：application/json 或 multipart/form-data

3. 字符编码：UTF-8

4. 所有的金额单位均为 USDT，保留2位小数。

签名算法

1. 将所有请求参数（空值参数不参与签名）按照参数名ASCII码从小到大排序。

2. 使用URL键值对格式（key1=value1&key2=value2...）拼接成字符串。

3. 在字符串末尾拼接 &key=API_SECRET。

4. 对字符串进行 MD5 运算，并将结果转为大写，即为签名值。

PHP 示例代码：


function generateSign($params, $apiSecret) {
    ksort($params); // 按键名排序
    $str = '';
    foreach ($params as $k => $v) {
        if ($v !== '' && $v !== null && $k != 'sign') {
            $str .= $k . '=' . $v . '&';
        }
    }
    $str .= 'key=' . $apiSecret;
    return strtoupper(md5($str));
}

创建订单

POST /api/gateway?action=create_order

请求参数

参数名	必填	类型	说明
merchant_no	是	string	商户号
merchant_order_no	是	string	商户订单号（唯一）
amount	是	decimal	订单金额 (USDT)
sign	是	string	签名

响应示例


{
    "code": 0,
    "message": "success",
    "data": {
        "order_no": "202310270001",
        "merchant_order_no": "ORDER_123456",
        "amount": "100.00",
        "wallet_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
        "expire_at": "2023-10-27 12:30:00",
        "pay_url": "https://your-domain.com/pay.html?order_no=202310270001"
    }
}

异步回调

当用户支付成功后，系统会向商户配置的回调地址发送 POST 请求。

回调参数

参数名	类型	说明
merchant_no	string	商户号
order_no	string	系统订单号
merchant_order_no	string	商户订单号
amount	decimal	订单金额
actual_amount	decimal	实收金额
tx_hash	string	交易哈希
status	int	状态 (1:支付成功)
sign	string	签名

商户响应

商户收到回调并处理成功后，请返回纯字符串 success，否则系统会进行重试。