统一下单（API）
<p><strong>使用场景：</strong> </p>
<ul>
<li>业务系统无需使用通企付小程序收银台，通过此接口指定支付方式，直接向通企付请求下单并完成支付</li>
</ul>
<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 style="text-align: left;">描述</th>
<th style="text-align: left;">示例值</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 style="text-align: left;">商户号</td>
<td style="text-align: left;"></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 style="text-align: left;">应用ID</td>
<td style="text-align: left;"></td>
</tr>
<tr>
<td style="text-align: left;">orgId</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(24)</td>
<td style="text-align: left;">服务商号</td>
<td style="text-align: left;"></td>
</tr>
<tr>
<td style="text-align: left;">reqTime</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">long</td>
<td style="text-align: left;">请求接口时间,13位时间戳</td>
<td style="text-align: left;"></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 style="text-align: left;">接口版本号，固定：1.0</td>
<td style="text-align: left;"></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 style="text-align: left;">签名值，详见签名算法</td>
<td style="text-align: left;"></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 style="text-align: left;">签名类型</td>
<td style="text-align: left;">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 style="text-align: left;">商户订单号，商户系统唯一</td>
<td style="text-align: left;"></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 style="text-align: left;">支付方式</td>
<td style="text-align: left;">参考附录1.1支付方式说明</td>
</tr>
<tr>
<td style="text-align: left;">amount</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">支付金额,单位分</td>
<td style="text-align: left;"></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 style="text-align: left;">三位货币代码,人民币:cny</td>
<td style="text-align: left;">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 style="text-align: left;">客户端IPV4地址</td>
<td style="text-align: left;"></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 style="text-align: left;">商品描述</td>
<td style="text-align: left;"></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 style="text-align: left;">异步通知地址，支付结果异步回调URL</td>
<td style="text-align: left;"></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 style="text-align: left;">支付结果同步跳转通知URL</td>
<td style="text-align: left;"></td>
</tr>
<tr>
<td style="text-align: left;">expiredTime</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">订单失效时间,单位秒,默认1小时.订单在(创建时 间+失效时间)后失效</td>
<td style="text-align: left;">3600</td>
</tr>
<tr>
<td style="text-align: left;">channelExtra</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(512)</td>
<td style="text-align: left;">渠道参数， 特定渠道发起的额外参数(json字符串)</td>
<td style="text-align: left;">openid:用户标识<br>subAppid:微信公众号/小程序appid</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 style="text-align: left;">商户扩展参数,回调时会原样返回</td>
<td style="text-align: left;"></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 style="text-align: left;">描述</th>
<th style="text-align: left;">示例值</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 style="text-align: left;">返回码</td>
<td style="text-align: left;">0：处理成功<br>9999：自定义业务异常<br>4000：用户名/密码错误<br>10：系统异常</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 style="text-align: left;">返回信息，具体错误原因，例如：签名失败、参数格式校验错误</td>
<td style="text-align: left;"></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 style="text-align: left;">签名信息，对data内数据签名,如data为空则不返回</td>
<td style="text-align: left;"></td>
</tr>
<tr>
<td style="text-align: left;">data</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">Json</td>
<td style="text-align: left;">返回下单数据,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 style="text-align: left;">描述</th>
<th style="text-align: left;">示例值</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 style="text-align: left;">通企付订单号</td>
<td style="text-align: left;"></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 style="text-align: left;">商户订单号</td>
<td style="text-align: left;"></td>
</tr>
<tr>
<td style="text-align: left;">orderState</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">支付订单状态<li>0-订单生成 <li>1-进行中 <li>2-支付成功 <li>3-支付失败 <li>4-已撤销 <li>5-已退款 <li>6-订单关闭<li>7-预消费支付成功</td>
</tr>
<tr>
<td style="text-align: left;">payDataType</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">支付数据类型</td>
<td style="text-align: left;"></td>
</tr>
<tr>
<td style="text-align: left;">wayCode</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">支付方式</td>
</tr>
<tr>
<td style="text-align: left;">payData</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">发起支付用到的支付参数</td>
<td style="text-align: left;"></td>
</tr>
<tr>
<td style="text-align: left;">errCode</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">上游渠道返回的错误码</td>
<td style="text-align: left;"></td>
</tr>
<tr>
<td style="text-align: left;">errMsg</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">上游渠道返回的错误描述</td>
<td style="text-align: left;"></td>
</tr>
</tbody>
</table>