加密货币支付接口
1245字约4分钟
注意
阅读该接口文档前,务必先查看 接口说明
代收API
代收申请
简要描述:
- 创建代收订单
注意
此地址只用作一次性(临时)转账,有效期为生成地址后的.
1. 请不要保存地址做二次转账操作
2. 请不要在过期后操作转账
URL:
USDT: /usdt/collect/apply
参数:
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
appId | 是 | Long | 业务ID(后台获取) |
orderId | 是 | String | 商户订单号(必须保证唯一性) |
name | 是 | String | 用户姓名 |
phone | 是 | String | 手机号,(格式参考 电话号码格式 ) |
是 | String | 电子邮件 | |
amount | 是 | String | 交易金额(禁止添加标点符号,例如:”,”) 范围参考:0.0001-5000000 |
payType | 是 | String | 固定值:EWALLET |
inBankCode | 是 | String | EWALLET(收银台模式);指定链: TRX,ETH |
callBackUrl | 是 | String | 支付完成后跳转地址 |
subject | 否 | String | 支付备注 |
body | 否 | String | 备注详情 |
userId | 是 | Long | 用户唯一标识 |
clientType | 是 | String | APP、WEB、WAP、MINIAPP、OTHERS |
currency | 是 | String | 法币 |
sign | 是 | String | 签名 |
返回data参数说明
参数名 | 类型 | 说明 |
---|---|---|
orderId | String | 商户订单号(必须保证唯一性) |
orderNo | String | 平台订单号 |
payUrl | String | 支付链接 |
exchangeRate | String | 汇率 |
orderAmount | String | 转换后的币种金额 |
amount | String | 下单原始币种金额 |
bankNo | String | 链地址 |
sign | String | 签名 |
代收查询
URL:
USDT: /usdt/collect/query
参数:
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
appId | 是 | Long | 业务ID(后台获取) |
orderId | 是 | String | 商户订单号 |
orderNo | 否 | String | 平台订单号(响应快) |
sign | 是 | String | 签名 |
返回data参数说明
参数名 | 类型 | 说明 |
---|---|---|
orderId | String | 商户订单号(必须保证唯一性) |
orderNo | String | 平台订单号 |
amount | String | 交易金额 |
actualAmount | String | 收到金额 |
fee | String | 手续费 |
status | Integer | 状态(0未开始,1支付中,2成功(终态),3失败(终态),4部分收款(终态),5超额收款(终态), -1异常待确认) |
payTime | String | 支付成功时间(当status=2时有值)(本地时间), 格式: yyyy-MM-dd HH:mm:ss |
errorMsg | String | 支付失败原因(当status=3时有值) |
sign | String | 签名 |
代付API
代付申请
简要描述:
- 创建代付订单
URL:/usdt/pay/apply
参数:
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
appId | 是 | Long | 业务ID(后台获取) |
orderId | 是 | String | 商户订单号(必须保证唯一性) |
amount | 是 | String | 交易金额(单位:usdt,精确到小数点后两位;禁止添加标点符号,例如:”,”) 范围:0.0001-5000000 |
accountType | 是 | String | 账户类型:EWALLET |
bankCode | 是 | String | 链名称 |
accountNo | 是 | String | 地址 |
name | 是 | String | 收款人姓名(收款人姓名 格式:英文大小写且允许有空格,1-30位,"firstName middleName lastName" (middleName 非必填, 特殊字符支持 '.-)) |
phone | 是 | String | 手机号(格式参考 电话号码格式 ) |
是 | String | 电子邮件 | |
subject | 否 | String | 支付备注(交易标题,商品名称,支付原因) |
body | 否 | String | 备注详情 |
sign | 是 | String | 签名 |
返回data参数说明
参数名 | 必选 | 类型 |
---|---|---|
orderId | String | 商户订单号(必须保证唯一性) |
orderNo | String | 平台订单号 |
sign | String | 签名 |
代付查询
简要描述:
- 创建代付订单
URL:/usdt/pay/query
参数:
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
appId | 是 | Long | 业务ID(后台获取) |
orderId | 是 | String | 商户订单号 |
orderNo | 否 | String | 平台订单号(响应快) |
sign | 是 | String | 签名 |
返回data参数说明
参数名 | 类型 | 说明 |
---|---|---|
orderId | String | 商户订单号(必须保证唯一性) |
orderNo | String | 平台订单号 |
amount | String | 交易金额 |
fee | String | 手续费 |
status | Integer | 状态(0未开始,1支付中,2成功(终态),3失败(终态), -1异常待确认) |
payTime | String | 支付成功时间(当status=2时有值)(纽约时间), 格式: yyyy-MM-dd HH:mm:ss |
errorMsg | String | 支付失败原因(当status=3时有值) |
sign | String | 签名 |
链名称
编码(bankCode) | 描述 |
---|---|
ETH | ETH/ERC20,金额>=5 |
TRX | Tron/TRC20,金额>=2 |
注意事项
注意
- 支付时效性:涉及到链上交易情况的话,还是取决于各条链的处理速度和拥堵情况
- 有效期内足额支付成功,实时发送回调信息,不用等订单过了有效期,即使支付多笔才足额,只要足额后就会实时回调给商户
- 有效期内支付多笔都还没有足额,就会等有效期过后,统一回调商户,回调金额为实际支付金额,与订单金额可能有差异
- 有效期外支付的,需要人工核对,若未收到,则会造成资金损失,若收到,进行补单操作即可,因此,为避免资金损失,请在有效期内支付
- 链上支付会有链处理费(GAS费,与本平台无关),与实际到账金额有差异