USDTAPI

接口文档


统一下单

<h2>2. 统一下单</h2> <p>&gt; 接口描述</p> <p>业务通过统一下单接口可以发起任意三方支付渠道的支付订单。业务系统不必关心该如何调用三方支付,统一下单接口会根据业务系统选择的支付渠道ID,选择对应支付渠道的支付产品,发起下单请求,然后响应给业务系统支付请求所需参数。</p> <p>&gt; 接口链接</p> <p>URL地址:{payUrl}/api/pay/create_order</p> <p>&gt; 请求参数</p> <table> <thead> <tr> <th>字段名</th> <th>变量名</th> <th>必填</th> <th>类型</th> <th>示例值</th> <th>描述</th> </tr> </thead> <tbody> <tr> <td>平台ID</td> <td>platId</td> <td>是</td> <td>String(30)</td> <td>1000</td> <td>支付中心分配的平台ID</td> </tr> <tr> <td>商户订单号</td> <td>mchOrderNo</td> <td>是</td> <td>String(30)</td> <td>20160427210604000490</td> <td>商户生成的订单号</td> </tr> <tr> <td>支付金额</td> <td>amount</td> <td>是</td> <td>int</td> <td>100</td> <td>支付金额,单位分</td> </tr> <tr> <td>客户端IP</td> <td>clientIp</td> <td>否</td> <td>String(32)</td> <td>210.73.10.148</td> <td>客户端IP地址</td> </tr> <tr> <td>异步回调地址</td> <td>notifyUrl</td> <td>否</td> <td>String(128)</td> <td><a href="http://shop.xx.com/notify.htm">http://shop.xx.com/notify.htm</a></td> <td>支付结果异步回调URL,只有传了该值才会发起回调</td> </tr> <tr> <td>同步请求地址</td> <td>returnUrl</td> <td>否</td> <td>String(128)</td> <td><a href="http://shop.xx.com/return.htm">http://shop.xx.com/return.htm</a></td> <td>支付结果同步请求URL</td> </tr> <tr> <td>请求时间</td> <td>reqTime</td> <td>是</td> <td>String(30)</td> <td>20190723141000</td> <td>请求接口时间, yyyyMMddHHmmss格式</td> </tr> <tr> <td>接口版本</td> <td>version</td> <td>是</td> <td>String(3)</td> <td>1.0</td> <td>接口版本号,固定:1.0</td> </tr> <tr> <td>签名</td> <td>sign</td> <td>是</td> <td>String(32)</td> <td>C380BEC2BFD727A4B6845133519F3AD6</td> <td>签名值,详见签名算法</td> </tr> </tbody> </table> <p>&gt; 响应结果</p> <table> <thead> <tr> <th>字段名</th> <th>变量名</th> <th>必填</th> <th>类型</th> <th>示例值</th> <th>描述</th> </tr> </thead> <tbody> <tr> <td>返回状态码</td> <td>code</td> <td>是</td> <td>String(16)</td> <td>0</td> <td>0-处理成功,其他-处理有误,详见错误码</td> </tr> <tr> <td>返回信息</td> <td>msg</td> <td>否</td> <td>String(128)</td> <td>签名失败</td> <td>具体错误原因,例如:签名失败、参数格式校验错误</td> </tr> </tbody> </table> <h5>以下字段在code=0 时有返回</h5> <table> <thead> <tr> <th>字段名</th> <th>变量名</th> <th>必填</th> <th>类型</th> <th>示例值</th> <th>描述</th> </tr> </thead> <tbody> <tr> <td>支付订单号</td> <td>payOrderId</td> <td>是</td> <td>String(30)</td> <td>U12021022311124442600</td> <td>返回支付系统订单号</td> </tr> <tr> <td>商户订单号</td> <td>mchOrderNo</td> <td>是</td> <td>String(30)</td> <td>20160427210604000490</td> <td>返回商户传入的订单号</td> </tr> <tr> <td>支付跳转地址</td> <td>payUrl</td> <td>否</td> <td>text</td> <td><a href="http://pay.zhifu.com/api/pay/cashier/U12021022311124442600">http://pay.zhifu.com/api/pay/cashier/U12021022311124442600</a></td> <td>payMethod=urlJump时存在该参数;支付收银台跳转地址,可直接重定向的URL</td> </tr> <tr> <td>转币地址</td> <td>payAddress</td> <td>是</td> <td>String(256)</td> <td>TVZaBC8rZN7DHYUwa4YC28Jsd8K5iF9Bh4</td> <td>需要转入的USDT地址</td> </tr> <tr> <td>通道类型</td> <td>channelType</td> <td>是</td> <td>String(32)</td> <td>TRC20</td> <td>该地址的USDT类型</td> </tr> <tr> <td>费率快照</td> <td>rateSnapshot</td> <td>是</td> <td>String(32)</td> <td>6.32</td> <td>当前订单USDT汇率快照</td> </tr> <tr> <td>下单金额-RMB</td> <td>amountRmb</td> <td>是</td> <td>int</td> <td>100</td> <td>下单金额-RMB,单位分</td> </tr> <tr> <td>下单金额-USDT</td> <td>amountUsdt</td> <td>是</td> <td>String</td> <td>0.156</td> <td>下单金额-USDT,单位个</td> </tr> <tr> <td>实际付款金额-RMB</td> <td>realAmountRmb</td> <td>是</td> <td>int</td> <td>100</td> <td>实际付款金额-RMB,单位分</td> </tr> <tr> <td>实际付款金额-USDT</td> <td>realAmountUsdt</td> <td>是</td> <td>String</td> <td>0.156</td> <td>实际付款金额-USDT,单位个</td> </tr> <tr> <td>签名信息</td> <td>sign</td> <td>是</td> <td>String(128)</td> <td>CCD9083A6DAD9A2DA9F668C3D4517A84</td> <td>签名信息</td> </tr> </tbody> </table>

页面列表

ITEM_HTML