商户发起转账/提现/代付 API 文档

---

概述

• 服务地址：https://api.crossingpay.com

• 数据格式：JSON

注意：本接口默认已集成订单反查功能，本地调试可以联系客服关闭。

接口地址

POST /api/transfer

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

请求类型        
application/json

请求参数

参数名	类型	必填	说明
apikey	string	是	商户 APIKey
toAddress	string	是	收款地址（TRC20 地址）
order_no	string	是	订单号（唯一）
amount	string	是	转账金额（USDT）
initiator	string	否	商户业务系统的用户唯一标识,可以是UUID，也可以是用户昵称等
callback_url	string	是	代付成功后回调地址

请求示例

{
    "apikey": "69b1f2fa-xxx-xxx-xxx-063bf080e376",
    "toAddress": "TJvDxAbMwzjxxx2Dobtw5RKNNjE",
    "order_no": "20250xxx123345",
    "initiator": "zh",
    "callback_url": "https://www.xx.com/transfer",
    "amount": "1"
}

 成功响应

{
    "message": "转账请求成功，等待审核",
    "order": "202504xxx345",
    "systemOrderID": "202505xxx208322"
}

如果后端开启自助审核就直接转账，如果是需要手动审核的，请到后台审核后出款

 订单反查说明(默认已开启订单反查，本地调试的时候，找客服先关闭反查功能)

订单反查是指通过提交上来的转出支付请求的验证，需要向支付平台验证后才能正常出款，防止非正常转款；反查请求链接，需要通过系统设置进行配置。

请求参数：

请求方式:POST 'Content-Type: application/json'
{
    "To_address": "转出地址",
    "Order_sn": "单号",
    "Amount": "系统金额"
}

反查响应：

只有响应如下内容视为成功，其他均为失败

{
    "code":200,
    "message": "success"
}

提现通知回调说明

当订单审核通过后，系统会向预留参数（callback_url）发起请求，通知业务系统。

请求参数：

{  "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：请求签名

业务响应：

当网络状态码为200时，视为回调通知成功

{
    "code":200,
    "message": "success"
}

错误响应：

HTTP 状态码	说明
400	参数错误
401	无效 APIKey
500	服务端错误

 鉴权方式

通过 apikey 参数校验商户身份