统一下单
<h2>2. 统一下单</h2>
<p>> 接口描述</p>
<p>业务通过统一下单接口可以发起任意三方支付渠道的支付订单。业务系统不必关心该如何调用三方支付,统一下单接口会根据业务系统选择的支付渠道ID,选择对应支付渠道的支付产品,发起下单请求,然后响应给业务系统支付请求所需参数。</p>
<p>> 接口链接</p>
<p>URL地址:{payUrl}/api/pay/create_order</p>
<p>> 请求参数</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>> 响应结果</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>