数字货币USDT支付通道对接文档大全，专业稳定安全对接全行业

版本号：V0.5

1. 提交订单接口(网关)
   接入方按要求拼装参数，得到的地址提供到前台跳转即可。md5key从后台取到。

请求方式：GET

接口地址： https://we.ustdotc.com/payment/{客户ID}(后台获得)

参数

参数名 是否必填 说明
orderNo Y 商户订单号，最大长度32个字符
customerId Y 买家姓名
orderCurrency Y 订单币种，固定值：USDT或CNY
orderAmount Y 订单金额，USDT单位为个，CNY单位为元
receiveUrl Y 通知回调地址
pickupUrl Y 交易完成跳转地址
signType Y 签名类型，固定值：MD5
sign Y 签名
签名方法:

将参数按以下顺序拼接，然后使用MD5进行hash运算得到sign值

pickupUrl + receiveUrl + signType + orderNo + orderAmount + orderCurrency + customerId + md5Key

如：

sign = md5( pickupUrl + receiveUrl + signType + orderNo + orderAmount + orderCurrency + customerId + md5Key );

得到跳转url为:( url参数 分顺序,注意参数值要urlencode )

https://we.ustdotc.com/payment/xx?orderNo=xx&customerId=xx&orderCurrency=xx&orderAm ount=xx&receiveUrl=xx&pickupUrl=xx&signType=xx&sign=xx

备注

如订单币种为CNY，则会按最新汇率自动转换为等值USDT数量，数量将四舍五入保留两位有效数字。

2. 提交订单接口（API）
   如接入方需要使用自己的支付页面，可以请求此接口，此接口会返回支付页面所需要的数据。

请求方式：POST

接口地址： https://we.ustdotc.com/api/payment/{客户ID}(后台获得)

数据格式：JSON

参数与网关接口相同

返回值

参数名 是否必填 说明
order_no Y 平台订单号
outorderno Y 商户订单号
usdt_amount Y 兑换USDT个数，单位为个
cny_amount Y 需支付人民币金额，单位为元
exchange_rate Y 汇率，值为兑换1USDT需要的人民币数量
seller_info Y 承兑商收款信息，具体内容见承兑商收款信息
承兑商收款信息

参数名 是否必填 说明
bank_name Y 收款类型（中文）：银行卡转账、支付宝转账、微信转账、支付宝红包
bank_type Y 收款类型（数字）：1.支付宝转账、2.银行卡转账、3.支付宝红包、4.微信转账
bank_info Y 具体收款信息，银行卡转账为银行卡信息，其他类型为url
返回值示例

{
“code”: 200,
“data”: {
“order_no”: “C2019032614202793182”,
“out_order_no”: “C2019032018024198256”,
“usdt_amount”: “14.47”,
“cny_amount”: “100”,
“exchange_rate”: “6.9100”,
“seller_info”: [
{
“bank_name”: “银行卡转账”,
“bank_type”: 2,
“bank_info”: {
“card_no”: “124123432455”,
“bank_name”: “工商银行”,
“name”: “张三”
}
},
{
“bank_name”: “支付宝红包”,
“bank_type”: 3,
“bank_info”: {
“url”: “https://qr.alipay.com/xxxxxxxxxxxxxxxx”
}
}
]
},
“msg”: “ok”
}
3. 用户确认转账接口
此接口用于接入方使用自己的支付页面时，需要用户确认已完成转账，并通知平台

请求方式：POST

接口地址： https://we.ustdotc.com/api/check/{客户ID}(后台获得)

参数

参数名 是否必填 含义
orderNo Y 商户订单号
4. 订单成功回调通知
订单确认成功后，系统取出提交订单时的receiveUrl参数作为通知地址。一般5s左右发起回调。

请求方式：POST

数据格式：application/x-www-form-urlencoded

参数

参数名 是否必填 含义
orderNo Y 商户订单号
orderAmount Y 订单金额
orderCurrency Y 订单币种， 固定值： USDT
paymentAmount Y 用户支付金额，单位：元，币种：人民币
transactionId Y 平台流水号
status Y 状态说明，固定值：success
signType Y 签名算法，固定值：MD5
sign Y 参数校验签名
签名方法:

使用如下字段的值，按下面给出的顺序进行拼接，并进行md5加密

signType + orderNo + orderAmount + orderCurrency + transactionId + status + md5Key

如： sign = md5( signType + orderNo + orderAmount + orderCurrency + transactionId + sta tus + md5Key );

然后对 sign值来判断请求是否为伪造。

响应

接入方应幂等性返回字符串success，系统收到后将视为通知成功。如遇到错误，系统将间隔30s重复通知5次，直到收到success为止。

5. 提币出金接口文档
   接口地址：https://we.ustdotc.com/api/withdrawal
   请求方式：POST
   请求参数：
   参数 是否必填 说明 示例
   channel_id Y 商户ID(后台获得) jrjr
   out_order_no N 商户订单号 12345
   notify_url N 接收提币出金状态通知的地址 http://baidu.com
   currency Y 出金币种，固定值： USDT或CNY USDT
   cards currency为CNY时必须 出金银行卡信息，具体信息见银行卡信息 [{“name”: “赵忠祥”,“cardno”:“6225880149058227”,“bankname”:“招商银行北京支行”,“amount”:200},{“name”: “赵祥”,“cardno”:“6225880149058224”,“bankname”:“招商银行北京支行”,“amount”:100}]
   coin_addresses currency为USDT时必须 出金钱包账户信息，具体信息见钱包账户信息 [{“address”:“xxxxxxxxxxxxxx”,“amount”:200,“remark”:""},{“address”:“yyyyyyyyyyyyyy”,“amount”:500,“remark”:""}]
   channel_remark N 备注 备注信息
   sign_type Y 签名算法，目前为固定值：MD5 MD5
   sign Y 参数签名 xxxxxxxxx
   签名方法：首先对所有请求参数按参数名做字典序升序排列，然后将排序好的请求参数按 “参数名”=“参数值”的形式以“&”拼接，将key拼接在字符串后面，对拼接后的字符串进行urlencode，最后对urlencode后的字符串进行md5加密

php签名示例
function getSign($data, KaTeX parse error: Expected '}', got 'EOF' at end of input: …y) { ksort(data);
$data[‘key’] = $key;
$blankStr = http_build_query($data);
$sign = md5($blankStr);
return strtoupper($sign);
}
银行卡信息
格式：JSON，可以为多个
参数 是否必填 说明
name Y 收款银行卡账户名
cardno Y 收款银行卡卡号
bankname Y 收款银行卡开户行
amount Y 收款金额，单位：元
钱包账户信息
格式：JSON,可以为多个
参数 是否必填 说明
address Y 收款钱包地址
amount Y 收款金额，单位：个
remark N 备注
返回值
格式：JSON
参数 说明
code 200为成功，其他为失败
data 此接口固定为null
msg 信息，成功时为：ok,失败时为具体错误信息
6. 提币出金成功回调通知
提币出金确认成功后，系统会取出提交订单时的notify_url参数作为通知地址。一般5s左右发起回调。

请求方式：POST

数据格式：application/x-www-form-urlencoded

参数

参数名 是否必填 含义
orderNo Y 商户订单号
amount Y 订单金额
currency Y 订单币种， 固定值： USDT或CNY
transactionId Y 平台流水号
status Y 状态说明，固定值：success
signType Y 签名算法，固定值：MD5
sign Y 参数校验签名
签名方法:

参考提币出金签名方法

响应

接入方应幂等性返回字符串success，系统收到后将视为通知成功。如遇到错误，系统将间隔30s重复通知5次，直到收到success为止。

7. 获取汇率接口
   商户可调用此接口，获取平台实时汇率

接口地址：https://we.ustdotc.com/api/get_exchange_rate
请求方式：POST
请求参数：
参数名 是否必填 含义
version Y 版本号，固定值：3.0
channel_id Y 商户ID(后台获取)
返回值
{
“code”:0,
“exchange_rate”:{
“usdt_to_cny”:6.78, //出金汇率
“cny_to_usdt”:6.93 //入金汇率
}
}