统一下单
<p><strong>请求URL：</strong></p>
<ul>
<li><code>/pay/unifiedOrder</code></li>
</ul>
<p><strong>请求方式：</strong></p>
<ul>
<li>POST</li>
</ul>
<p><strong>请求类型：</strong></p>
<ul>
<li>application /json</li>
</ul>
<p><strong>参数：</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">mchNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(30)</td>
<td>商户号</td>
</tr>
<tr>
<td style="text-align: left;">appId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(24)</td>
<td>应用ID</td>
</tr>
<tr>
<td style="text-align: left;">reqTime</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(13)</td>
<td>请求时间，13位时间戳</td>
</tr>
<tr>
<td style="text-align: left;">version</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(3)</td>
<td>接口版本，固定：1.0</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(32)</td>
<td>签名</td>
</tr>
<tr>
<td style="text-align: left;">signType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(32)</td>
<td>签名类型，MD5/RSA/SM2</td>
</tr>
<tr>
<td style="text-align: left;">mchOrderNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(30)</td>
<td>商户订单号</td>
</tr>
<tr>
<td style="text-align: left;">tradeType</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(5)</td>
<td>交易类型，<br>GT：担保交易<br>RT：实时交易<br>RG：充值交易（仅云商通一代支持）<br>默认为实时交易</td>
</tr>
<tr>
<td style="text-align: left;">wayCode</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(30)</td>
<td>支付方式，见数据字典</td>
</tr>
<tr>
<td style="text-align: left;">amount</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>支付金额,单位分</td>
</tr>
<tr>
<td style="text-align: left;">currency</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(3)</td>
<td>货币代码,人民币:cny</td>
</tr>
<tr>
<td style="text-align: left;">clientIp</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(32)</td>
<td>客户端IP,IPV4地址</td>
</tr>
<tr>
<td style="text-align: left;">subject</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(64)</td>
<td>商品标题</td>
</tr>
<tr>
<td style="text-align: left;">body</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(256)</td>
<td>商品描述</td>
</tr>
<tr>
<td style="text-align: left;">notifyUrl</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(128)</td>
<td>支付结果异步回调URL,只有传了该值才会发起回调</td>
</tr>
<tr>
<td style="text-align: left;">returnUrl</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(128)</td>
<td>支付结果同步跳转通知URL，H5收银台支付方式必填</td>
</tr>
<tr>
<td style="text-align: left;">expiredTime</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>订单失效时间,单位秒,默认10分钟.订单在(创建时 间+失效时间)后失效</td>
</tr>
<tr>
<td style="text-align: left;">channelExtra</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(256)</td>
<td>特定渠道发起的额外参数<br>详见数据字典说明，<br>（1）当交易类型为RT实时交易时，recieverList仅支持上送一个收款方会员id，且收款方金额必须等于支付金额；<br>（2）当交易类型为GT担保交易且分账模式为1-自动分账时，recieverList仅支持上送一个收款方会员id，且收款方金额必须等于支付金额</td>
</tr>
<tr>
<td style="text-align: left;">divisionMode</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>分账模式：<br> 0-该笔订单不允许分账[默认]<br> 1-支付成功按配置自动完成分账<br> 2-商户手动分账(解冻商户金额)</td>
</tr>
<tr>
<td style="text-align: left;">extParam</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(512)</td>
<td>商户扩展参数,回调时会原样返回</td>
</tr>
<tr>
<td style="text-align: left;">storeId</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>门店编号</td>
</tr>
</tbody>
</table>
<p><strong>返回参数</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">code</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>返回状态：0-处理成功，其他-处理有误，具体错误详见msg字段</td>
</tr>
<tr>
<td style="text-align: left;">msg</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(128)</td>
<td>返回信息：具体错误原因，例如：签名失败、参数格式校验错误</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(32)</td>
<td>签名信息：对data内数据签名，如data为空则不返回</td>
</tr>
<tr>
<td style="text-align: left;">data</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">Json</td>
<td>返回数据：json格式数据</td>
</tr>
</tbody>
</table>
<p><strong>data数据格式</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">payOrderId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(30)</td>
<td>支付订单号</td>
</tr>
<tr>
<td style="text-align: left;">mchOrderNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(30)</td>
<td>商户订单号</td>
</tr>
<tr>
<td style="text-align: left;">orderState</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>支付订单状态<br> 0-订单生成<br> 1-支付中<br> 2-支付成功<br> 3-支付失败<br> 4-已撤销<br> 5-已退款<br> 6-订单关闭</td>
</tr>
<tr>
<td style="text-align: left;">payDataType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>支付数据类型，见数据字典定义</td>
</tr>
<tr>
<td style="text-align: left;">payData</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>支付数据，根据具体payDataType返回支付数据</td>
</tr>
<tr>
<td style="text-align: left;">errCode</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>渠道错误码</td>
</tr>
<tr>
<td style="text-align: left;">errMsg</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>渠道错误描述</td>
</tr>
</tbody>
</table>
<p>向returnUrl跳转
支付完成后,交易成功后点击跳往商户网站,会跳往交易上送的returnUrl，有些支付方式不支持跳转。
注意：不能以此为支付结果，以交易结果通知接口为最终交易结果</p>
<p><strong>请求参数：</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">mchNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(30)</td>
<td>商户号</td>
</tr>
<tr>
<td style="text-align: left;">appId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(24)</td>
<td>应用ID</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(32)</td>
<td>签名</td>
</tr>
<tr>
<td style="text-align: left;">signType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(32)</td>
<td>签名类型，MD5/RSA/SM2</td>
</tr>
<tr>
<td style="text-align: left;">mchOrderNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(30)</td>
<td>商户订单号</td>
</tr>
<tr>
<td style="text-align: left;">payOrderId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(30)</td>
<td>支付订单号</td>
</tr>
<tr>
<td style="text-align: left;">amount</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>支付金额,单位分</td>
</tr>
</tbody>
</table>