支付接口
<h2>统一下单</h2>
<p>商户业务系统通过统一下单接口发起支付收款订单,易铭银通支付网关会根据商户配置的支付通道路由支付通道完成支付下单。支付网关根据不同的支付方式返回对应的支付参数,业务系统使用支付参数发起收款。</p>
<blockquote>
<p>适用对象:普通商户 特约商户</p>
</blockquote>
<p>请求URL:<a href="https://j.mirpays.com/api/pay/unifiedOrder" title="https://j.mirpays.com/api/pay/unifiedOrder"><a href="https://j.mirpays.com/api/pay/unifiedOrder">https://j.mirpays.com/api/pay/unifiedOrder</a></a></p>
<p>请求方式:<code>POST</code></p>
<p>请求类型:<code>application/json</code> 或 <code>application/x-www-form-urlencoded</code></p>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>字段名</th>
<th>变量名</th>
<th>必填</th>
<th>类型</th>
<th>示例值</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>商户号</td>
<td>mchNo</td>
<td>是</td>
<td>String(30)</td>
<td>M1621873433953</td>
<td>商户号</td>
</tr>
<tr>
<td>应用ID</td>
<td>appId</td>
<td>是</td>
<td>String(24)</td>
<td>60cc09bce4b0f1c0b83761c9</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>wayCode</td>
<td>是</td>
<td>String(30)</td>
<td>WX_LITE</td>
<td>支付方式,如微信小程序WX_LITE</td>
</tr>
<tr>
<td>支付金额</td>
<td>amount</td>
<td>是</td>
<td>int</td>
<td>100</td>
<td>支付金额,单位分</td>
</tr>
<tr>
<td>货币代码</td>
<td>currency</td>
<td>是</td>
<td>String(3)</td>
<td>cny</td>
<td>三位货币代码,人民币:cny</td>
</tr>
<tr>
<td>客户端IP</td>
<td>clientIp</td>
<td>否</td>
<td>String(32)</td>
<td>210.73.10.148</td>
<td>客户端IPV4地址</td>
</tr>
<tr>
<td>商品标题</td>
<td>subject</td>
<td>是</td>
<td>String(64)</td>
<td>易铭银通商品标题测试</td>
<td>商品标题</td>
</tr>
<tr>
<td>商品描述</td>
<td>body</td>
<td>是</td>
<td>String(256)</td>
<td>易铭银通商品描述测试</td>
<td>商品描述</td>
</tr>
<tr>
<td>异步通知地址</td>
<td>notifyUrl</td>
<td>否</td>
<td>String(128)</td>
<td><a href="https://j.mirpays.com/notify.htm">https://j.mirpays.com/notify.htm</a></td>
<td>支付结果异步回调URL,只有传了该值才会发起回调</td>
</tr>
<tr>
<td>跳转通知地址</td>
<td>returnUrl</td>
<td>否</td>
<td>String(128)</td>
<td><a href="https://j.mirpays.com/return.htm">https://j.mirpays.com/return.htm</a></td>
<td>支付结果同步跳转通知URL</td>
</tr>
<tr>
<td>失效时间</td>
<td>expiredTime</td>
<td>否</td>
<td>int</td>
<td>3600</td>
<td>订单失效时间,单位秒,默认2小时.订单在(创建时间+失效时间)后失效</td>
</tr>
<tr>
<td>渠道参数</td>
<td>channelExtra</td>
<td>否</td>
<td>String(256</td>
<td>{“auth_code”, “13920933111042”}</td>
<td>特定渠道发起的额外参数,json格式字符串.详见渠道参数说明</td>
</tr>
<tr>
<td>渠道用户</td>
<td>channelUser</td>
<td>否</td>
<td>String(256)</td>
<td>oIkQuwhPgPUgl-TvQ48_UUpZUwMs</td>
<td>渠道用户标识,如微信openId,支付宝账号</td>
</tr>
<tr>
<td>分账模式</td>
<td>divisionMode</td>
<td>否</td>
<td>int</td>
<td>0</td>
<td>分账模式: 0-该笔订单不允许分账[默认], 1-支付成功按配置自动完成分账, 2-商户手动分账(解冻商户金额)</td>
</tr>
<tr>
<td>扩展参数</td>
<td>extraParam</td>
<td>否</td>
<td>String(512)</td>
<td>134586944573118714</td>
<td>商户扩展参数,回调时会原样返回</td>
</tr>
<tr>
<td>请求时间</td>
<td>reqTime</td>
<td>是</td>
<td>long</td>
<td>1622016572190</td>
<td>请求接口时间,13位时间戳</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>
<tr>
<td>签名类型</td>
<td>signType</td>
<td>是</td>
<td>String(32)</td>
<td>MD5</td>
<td>签名类型,目前只支持MD5方式</td>
</tr>
</tbody>
</table>
<p><code>请求示例数据</code></p>
<pre><code class="language-java">{
"amount": 8,
"extParam": "",
"mchOrderNo": "mho1624005107281",
"subject": "商品标题",
"wayCode": "ALI_BAR",
"sign": "84F606FA25A6EC4783BECC08D4FDC681",
"reqTime": "1624005107",
"body": "商品描述",
"version": "1.0",
"channelExtra": "{\"authCode\":\"280812820366966512\"}",
"appId": "60cc09bce4b0f1c0b83761c9",
"clientIp": "192.166.1.132",
"notifyUrl": "https://j.mirpays.com",
"signType": "MD5",
"currency": "cny",
"returnUrl": "",
"mchNo": "M1623984572",
"divisionMode": 1
}</code></pre>
<blockquote>
<p>返回参数</p>
</blockquote>
<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>int</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>
<tr>
<td>签名信息</td>
<td>sign</td>
<td>否</td>
<td>String(32)</td>
<td>CCD9083A6DAD9A2DA9F668C3D4517A84</td>
<td>对data内数据签名,如data为空则不返回</td>
</tr>
<tr>
<td>返回数据</td>
<td>data</td>
<td>否</td>
<td>String(512)</td>
<td>{}</td>
<td>返回下单数据,json格式数据</td>
</tr>
</tbody>
</table>
<p><code>data数据格式</code></p>
<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>orderState</td>
<td>是</td>
<td>int</td>
<td>2</td>
<td>支付订单状态<br>0-订单生成<br>1-支付中<br>2-支付成功<br>3-支付失败<br>4-已撤销<br>5-已退款<br>6-订单关闭</td>
</tr>
<tr>
<td>支付数据类型</td>
<td>payDataType</td>
<td>是</td>
<td>String</td>
<td>payUrl</td>
<td>支付参数类型<br>payUrl-跳转链接的方式<br>form-表单方式 <br>wxapp-微信支付参数(微信公众号,小程序,app支付时)<br>aliapp-支付宝app支付参数<br>ysfapp-云闪付app支付参数 <br>codeUrl-二维码地址<br>codeImgUrl-二维码图片地址<br>none-空支付参数</td>
</tr>
<tr>
<td>支付数据</td>
<td>payData</td>
<td>否</td>
<td>String</td>
<td><a href="http://j.mirpays.com/pay.html" title="http://j.mirpays.com/pay.html"><a href="http://j.mirpays.com/pay.html">http://j.mirpays.com/pay.html</a></a></td>
<td>发起支付用到的支付参数,如果微信公众号支付等</td>
</tr>
<tr>
<td>渠道错误码</td>
<td>errCode</td>
<td>否</td>
<td>String</td>
<td>ACQ.PAYMENT_AUTH_CODE_INVALID</td>
<td>上游渠道返回的错误码</td>
</tr>
<tr>
<td>渠道错误描述</td>
<td>errMsg</td>
<td>否</td>
<td>String</td>
<td>Business Failed 失败</td>
<td>上游渠道返回的错误描述</td>
</tr>
</tbody>
</table>
<p><code>返回示例数据</code></p>
<pre><code class="language-php">{
"code": 0,
"data": {
"errCode": "ACQ.PAYMENT_AUTH_CODE_INVALID",
"errMsg": "Business Failed【支付失败,获取顾客账户信息失败,请顾客刷新付款码后重新收款,如再次收款失败,请联系管理员处理。[SOUNDWAVE_PARSER_FAIL]】",
"mchOrderNo": "mho1624005752661",
"orderState": 3,
"payOrderId": "P202106181642329900002"
},
"msg": "SUCCESS",
"sign": "F4DA202C516D1F33A12F1E547C5004FD"
}</code></pre>
<blockquote>
<p>支付方式</p>
</blockquote>
<hr />
<table>
<thead>
<tr>
<th>WayCode</th>
<th>支付方式</th>
</tr>
</thead>
<tbody>
<tr>
<td>QR_CASHIER</td>
<td>聚合扫码(用户扫商家)</td>
</tr>
<tr>
<td>AUTO_BAR</td>
<td>聚合条码(商家扫用户)</td>
</tr>
<tr>
<td>ALI_BAR</td>
<td>支付宝条码</td>
</tr>
<tr>
<td>ALI_JSAPI</td>
<td>支付宝生活号</td>
</tr>
<tr>
<td>ALI_APP</td>
<td>支付宝APP</td>
</tr>
<tr>
<td>ALI_WAP</td>
<td>支付宝WAP</td>
</tr>
<tr>
<td>ALI_PC</td>
<td>支付宝PC网站</td>
</tr>
<tr>
<td>ALI_QR</td>
<td>支付宝二维码</td>
</tr>
<tr>
<td>WX_BAR</td>
<td>微信条码</td>
</tr>
<tr>
<td>WX_JSAPI</td>
<td>微信公众号</td>
</tr>
<tr>
<td>WX_LITE</td>
<td>微信小程序</td>
</tr>
<tr>
<td>WX_APP</td>
<td>微信APP</td>
</tr>
<tr>
<td>WX_H5</td>
<td>微信H5</td>
</tr>
<tr>
<td>WX_NATIVE</td>
<td>微信扫码</td>
</tr>
<tr>
<td>YSF_BAR</td>
<td>云闪付条码</td>
</tr>
<tr>
<td>YSF_JSAPI</td>
<td>云闪付jsapi</td>
</tr>
</tbody>
</table>
<hr />
<blockquote>
<p>channelExtra参数说明</p>
</blockquote>
<p>当 <code>wayCode=AUTO_BAR</code> 或 <code>wayCode=ALI_BAR</code> 或 <code>wayCode=WX_BAR</code> 或 <code>wayCode=YSF_BAR</code> 时,channelExtra必须传auth_code,为用户的付款码值,channelExtra示例数据如:</p>
<pre><code>{"auth_code", "13920933111042"}</code></pre>
<p>当 <code>wayCode=ALI_JSAPI</code>时,channelExtra必须传buyerUserId,为支付宝用户ID,channelExtra示例数据如:</p>
<pre><code>{"buyerUserId", "2088702585070844"}</code></pre>
<p>当 <code>wayCode=WX_JSAPI</code> 或 <code>wayCode=WX_LITE</code> 时,channelExtra必须传openid,为支付宝用户ID,channelExtra示例数据如:</p>
<pre><code>{"openid", "o6BcIwvSiRpfS8e_UyfQNrYuk2LI"}</code></pre>
<p>当 <code>wayCode=QR_CASHIER</code> 或 <code>wayCode=ALI_QR</code> 或 <code>wayCode=WX_NATIVE</code> 时,channelExtra可以传payDataType设置返回支付数据支付类型。此时payDataType可以为:codeUrl-二维码地址,codeImgUrl-二维码图片地址,不传payDataType默认返回codeUrl类型, channelExtra示例数据如:</p>
<pre><code class="language-php">{"payDataType", "codeImgUrl"}</code></pre>
<p>当<code>wayCode=ALI_WAP</code>时,channelExtra可以传payDataType设置返回支付数据支付类型。此时payDataType可以为:form-返回自动跳转的支付表单,codeImgUrl-返回一个二维码图片URL,payUrl-返回支付链接,不传payDataType默认返回payUrl类型, channelExtra示例数据如:</p>
<pre><code class="language-php">{"payDataType", "form"}</code></pre>
<p>当<code>wayCode=ALI_PC</code>时,channelExtra可以传payDataType设置返回支付数据支付类型。此时payDataType可以为:form-返回自动跳转的支付表单,payUrl-返回支付链接,不传payDataType默认返回payUrl类型, channelExtra示例数据如:</p>
<pre><code>{"payDataType", "form"}</code></pre>
<h2>查询订单</h2>
<p>商户通过该接口查询订单,支付网关会返回订单最新的数据</p>
<blockquote>
<p>接口说明</p>
</blockquote>
<p>适用对象:<code>普通商户 特约商户</code></p>
<p>请求URL:<code>https://j.mirpays.com/api/pay/query</code></p>
<p>请求方式:<code>POST</code></p>
<p>请求类型:<code>application/json</code> 或<code>application/x-www-form-urlencoded</code></p>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>字段名</th>
<th>变量名</th>
<th>必填</th>
<th>类型</th>
<th>示例值</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>商户号</td>
<td>mchNo</td>
<td>是</td>
<td>String(30)</td>
<td>M1621873433953</td>
<td>商户号</td>
</tr>
<tr>
<td>应用ID</td>
<td>appId</td>
<td>是</td>
<td>String(24)</td>
<td>60cc09bce4b0f1c0b83761c9</td>
<td>应用ID</td>
</tr>
<tr>
<td>支付订单号</td>
<td>payOrderId</td>
<td>是</td>
<td>String(30)</td>
<td>P20160427210604000490</td>
<td>支付中心生成的订单号,与mchOrderNo二者传一即可</td>
</tr>
<tr>
<td>商户订单号</td>
<td>mchOrderNo</td>
<td>是</td>
<td>String(30)</td>
<td>20160427210604000490</td>
<td>商户生成的订单号,与payOrderId二者传一即可</td>
</tr>
<tr>
<td>请求时间</td>
<td>reqTime</td>
<td>是</td>
<td>long</td>
<td>1622016572190</td>
<td>请求接口时间,13位时间戳</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>
<tr>
<td>签名类型</td>
<td>signType</td>
<td>是</td>
<td>String(32)</td>
<td>MD5</td>
<td>签名类型,目前只支持MD5方式</td>
</tr>
</tbody>
</table>
<p><code>请求示例数据</code></p>
<pre><code class="language-php">{
"payOrderId": "P202106181104177050002",
"appId": "60cc09bce4b0f1c0b83761c9",
"sign": "46940C58B2F3AE426B77A297ABF4D31E",
"signType": "MD5",
"reqTime": "1624006009",
"mchNo": "M1623984572",
"version": "1.0"
}</code></pre>
<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>int</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>
<tr>
<td>签名信息</td>
<td>sign</td>
<td>否</td>
<td>String(32)</td>
<td>CCD9083A6DAD9A2DA9F668C3D4517A84</td>
<td>对data内数据签名,如data为空则不返回</td>
</tr>
<tr>
<td>返回数据</td>
<td>data</td>
<td>否</td>
<td>String(512)</td>
<td>{}</td>
<td>返回下单数据,json格式数据</td>
</tr>
</tbody>
</table>
<p><code>data数据格式</code></p>
<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>P12021022311124442600</td>
<td>返回支付系统订单号</td>
</tr>
<tr>
<td>商户号</td>
<td>mchNo</td>
<td>是</td>
<td>String(30)</td>
<td>M1621873433953</td>
<td>商户号</td>
</tr>
<tr>
<td>应用ID</td>
<td>appId</td>
<td>是</td>
<td>String(24)</td>
<td>60cc09bce4b0f1c0b83761c9</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>ifCode</td>
<td>是</td>
<td>String(30)</td>
<td>wxpay</td>
<td>支付接口编码</td>
</tr>
<tr>
<td>支付方式</td>
<td>wayCode</td>
<td>是</td>
<td>String(30)</td>
<td>WX_LITE</td>
<td>支付方式,如微信小程序WX_LITE</td>
</tr>
<tr>
<td>支付金额</td>
<td>amount</td>
<td>是</td>
<td>int</td>
<td>100</td>
<td>支付金额,单位分</td>
</tr>
<tr>
<td>货币代码</td>
<td>currency</td>
<td>是</td>
<td>String(3)</td>
<td>cny</td>
<td>三位货币代码,人民币:cny</td>
</tr>
<tr>
<td>订单状态</td>
<td>state</td>
<td>是</td>
<td>int</td>
<td>2</td>
<td>支付订单状态<br>0-订单生成<br>1-支付中<br>2-支付成功<br>3-支付失败<br>4-已撤销<br>5-已退款<br>6-订单关闭</td>
</tr>
<tr>
<td>客户端IP</td>
<td>clientIp</td>
<td>否</td>
<td>String(32)</td>
<td>210.73.10.148</td>
<td>客户端IPV4地址</td>
</tr>
<tr>
<td>商品标题</td>
<td>subject</td>
<td>是</td>
<td>String(64)</td>
<td>易铭银通商品标题测试</td>
<td>商品标题</td>
</tr>
<tr>
<td>商品描述</td>
<td>body</td>
<td>是</td>
<td>String(256)</td>
<td>易铭银通商品描述测试</td>
<td>商品描述</td>
</tr>
<tr>
<td>渠道订单号</td>
<td>channelOrderNo</td>
<td>否</td>
<td>String</td>
<td>20160427210604000490</td>
<td>对应渠道的订单号</td>
</tr>
<tr>
<td>渠道错误码</td>
<td>errCode</td>
<td>否</td>
<td>String</td>
<td>1002</td>
<td>渠道下单返回错误码</td>
</tr>
<tr>
<td>渠道错误描述</td>
<td>errMsg</td>
<td>否</td>
<td>String</td>
<td>134586944573118714</td>
<td>渠道下单返回错误描述</td>
</tr>
<tr>
<td>扩展参数</td>
<td>extraParam</td>
<td>否</td>
<td>String(512)</td>
<td>134586944573118714</td>
<td>商户扩展参数,回调时会原样返回</td>
</tr>
<tr>
<td>创建时间</td>
<td>createdAt</td>
<td>是</td>
<td>long</td>
<td>1622016572190</td>
<td>订单创建时间,13位时间戳</td>
</tr>
<tr>
<td>成功时间</td>
<td>successTime</td>
<td>否</td>
<td>long</td>
<td>1622016572190</td>
<td>订单支付成功时间,13位时间戳</td>
</tr>
</tbody>
</table>
<p><code>返回示例数据</code></p>
<pre><code class="language-php">{
"code": 0,
"data": {
"amount": 58,
"appId": "60cc09bce4b0f1c0b83761c9",
"body": "商品描述",
"channelOrderNo": "2021061822001423031419593035",
"clientIp": "192.166.1.132",
"createdAt": 1623985457705,
"currency": "cny",
"extParam": "",
"ifCode": "alipay",
"mchNo": "M1623984572",
"mchOrderNo": "mho1623985457320",
"payOrderId": "P202106181104177050002",
"state": 2,
"subject": "商品标题",
"successTime": 1623985459000,
"wayCode": "ALI_BAR"
},
"msg": "SUCCESS",
"sign": "9548145EA12D0CD8C1628BCF44E19E0D"
}
</code></pre>
<h2>支付通知</h2>
<p>当订单支付成功时,支付网关会向商户系统发起回调通知。如果商户系统没有正确返回,支付网关会延迟再次通知。</p>
<blockquote>
<p>接口说明</p>
</blockquote>
<p>适用对象:<code>普通商户 特约商户</code></p>
<p>请求URL:该链接是通过统一下单接口提交的参数<code>notifyUrl</code>设置,如果无法访问链接,商户系统将无法接收到支付中心的通知。</p>
<p>请求方式:<code>POST</code></p>
<p>请求类型:<code>application/x-www-form-urlencoded</code></p>
<blockquote>
<p>通知参数</p>
</blockquote>
<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>P12021022311124442600</td>
<td>返回支付系统订单号</td>
</tr>
<tr>
<td>商户号</td>
<td>mchNo</td>
<td>是</td>
<td>String(30)</td>
<td>M1621873433953</td>
<td>商户号</td>
</tr>
<tr>
<td>应用ID</td>
<td>appId</td>
<td>是</td>
<td>String(24)</td>
<td>60cc09bce4b0f1c0b83761c9</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>ifCode</td>
<td>是</td>
<td>String(30)</td>
<td>wxpay</td>
<td>支付接口编码</td>
</tr>
<tr>
<td>支付方式</td>
<td>wayCode</td>
<td>是</td>
<td>String(30)</td>
<td>WX_LITE</td>
<td>支付方式,微信小程序WX_LITE</td>
</tr>
<tr>
<td>支付金额</td>
<td>amount</td>
<td>是</td>
<td>int</td>
<td>100</td>
<td>支付金额,单位分</td>
</tr>
<tr>
<td>货币代码</td>
<td>currency</td>
<td>是</td>
<td>String(3)</td>
<td>cny</td>
<td>三位货币代码,人民币:cny</td>
</tr>
<tr>
<td>订单状态</td>
<td>state</td>
<td>是</td>
<td>int</td>
<td>2</td>
<td>支付订单状态<br>0-订单生成<br>1-支付中<br>2-支付成功<br>3-支付失败<br>4-已撤销<br>5-已退款<br>6-订单关闭</td>
</tr>
<tr>
<td>客户端IP</td>
<td>clientIp</td>
<td>否</td>
<td>String(32)</td>
<td>210.73.10.148</td>
<td>客户端IPV4地址</td>
</tr>
<tr>
<td>商品标题</td>
<td>subject</td>
<td>是</td>
<td>String(64)</td>
<td>易铭银通商品标题测试</td>
<td>商品标题</td>
</tr>
<tr>
<td>商品描述</td>
<td>body</td>
<td>是</td>
<td>String(256)</td>
<td>易铭银通商品描述测试</td>
<td>商品描述</td>
</tr>
<tr>
<td>渠道订单号</td>
<td>channelOrderNo</td>
<td>否</td>
<td>String</td>
<td>20160427210604000490</td>
<td>对应渠道的订单号</td>
</tr>
<tr>
<td>渠道错误码</td>
<td>errCode</td>
<td>否</td>
<td>String</td>
<td>1002</td>
<td>渠道下单返回错误码</td>
</tr>
<tr>
<td>渠道错误描述</td>
<td>errMsg</td>
<td>否</td>
<td>String</td>
<td>134586944573118714</td>
<td>渠道下单返回错误描述</td>
</tr>
<tr>
<td>扩展参数</td>
<td>extraParam</td>
<td>否</td>
<td>String(512)</td>
<td>134586944573118714</td>
<td>商户扩展参数</td>
</tr>
<tr>
<td>通知请求时间</td>
<td>reqTime</td>
<td>是</td>
<td>String(30)</td>
<td>1622016572190</td>
<td>通知请求时间,,13位时间戳</td>
</tr>
<tr>
<td>签名</td>
<td>sign</td>
<td>是</td>
<td>String(32)</td>
<td>C380BEC2BFD727A4B6845133519F3AD6</td>
<td>签名值,详见签名算法</td>
</tr>
</tbody>
</table>
<blockquote>
<p>返回结果</p>
</blockquote>
<p>业务系统处理后同步返回给支付中心,返回字符串 success 则表示成功,返回非success则表示处理失败,支付中心会再次通知业务系统。(通知频率为0/30/60/90/120/150,单位:秒)</p>
<p>注意:<code>返回的字符串必须是小写,且前后不能有空格和换行符</code>。</p>
<p><code>通知示例数据</code></p>
<pre><code class="language-php">{
"amount": 5,
"body": "商品描述",
"clientIp": "192.166.1.132",
"createdAt": "1622016572190",
"currency": "cny",
"extParam": "",
"ifCode": "wxpay",
"mchNo": "M1621873433953",
"appId": "60cc09bce4b0f1c0b83761c9",
"mchOrderNo": "mho1621934803068",
"payOrderId": "20210525172643357010",
"state": 3,
"subject": "商品标题",
"wayCode": "WX_BAR",
"sign": "C380BEC2BFD727A4B6845133519F3AD6"
}</code></pre>
<h2>获取渠道用户ID</h2>
<p>商户通过该接口获取渠道的用户ID,如微信的openID,支付宝的userId。该接口通过跳转获取到用户ID后,会跳转到商户上传的redirectUrl地址,并传递用户ID参数</p>
<blockquote>
<p>接口说明</p>
</blockquote>
<p>适用对象:<code>普通商户 特约商户</code></p>
<p>请求URL:<code>https://j.mirpays.com/api/channelUserId/jump</code></p>
<p>请求方式:<code>GET</code></p>
<p>请求类型:<code>application/json</code> 或<code>application/x-www-form-urlencoded</code></p>
<blockquote>
<p>请求参数</p>
</blockquote>
<table>
<thead>
<tr>
<th>字段名</th>
<th>变量名</th>
<th>必填</th>
<th>类型</th>
<th>示例值</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>商户号</td>
<td>mchNo</td>
<td>是</td>
<td>String(30)</td>
<td>M1621873433953</td>
<td>商户号</td>
</tr>
<tr>
<td>应用ID</td>
<td>appId</td>
<td>是</td>
<td>String(24)</td>
<td>60cc09bce4b0f1c0b83761c9</td>
<td>应用ID</td>
</tr>
<tr>
<td>支付接口</td>
<td>ifCode</td>
<td>是</td>
<td>String(30)</td>
<td>AUTO</td>
<td>目前只支持传 AUTO</td>
</tr>
<tr>
<td>跳转地址</td>
<td>redirectUrl</td>
<td>是</td>
<td>String</td>
<td><a href="https://www.mirpays.com">https://www.mirpays.com</a></td>
<td>获取到用户ID后,会携带用户ID参数跳转到该地址</td>
</tr>
<tr>
<td>请求时间</td>
<td>reqTime</td>
<td>是</td>
<td>long</td>
<td>1622016572190</td>
<td>请求接口时间,13位时间戳</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>
<tr>
<td>签名类型</td>
<td>signType</td>
<td>是</td>
<td>String(32)</td>
<td>MD5</td>
<td>签名类型,目前只支持MD5方式</td>
</tr>
</tbody>
</table>
<p><code>请求示例数据</code></p>
<pre><code class="language-php">{
"mchNo": "M1621873433953",
"appId": "60cc09bce4b0f1c0b83761c9",
"ifCode": "wxpay",
"redirectUrl": "https://j.mirpays.com",
"sign": "A5C93D50743126ED91AA6ED96CDEEEF8",
"signType": "MD5",
"reqTime": "1622011236571",
"version": "1.0"
}</code></pre>
<p><code>当获取到渠道用户ID后,会301重定向到跳转地址,传递参数如下</code></p>
<table>
<thead>
<tr>
<th>字段名</th>
<th>变量名</th>
<th>必填</th>
<th>类型</th>
<th>示例值</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>渠道用户ID</td>
<td>channelUserId</td>
<td>是</td>
<td>String</td>
<td>o6BcIwvSiRpfS8e_UyfQNrYuk2LI</td>
<td>渠道用户ID微信openId或支付userId</td>
</tr>
</tbody>
</table>
<p><code>完整跳转URL示例</code></p>
<pre><code class="language-php">https://j.mirpays.com/toU?channelUserId=o6BcIwvSiRpfS8e_UyfQNrYuk2LI
</code></pre>
<h2>返回码</h2>
<table>
<thead>
<tr>
<th>code</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>0</td>
<td>成功</td>
</tr>
<tr>
<td>9999</td>
<td>异常具体错误详见msg字段</td>
</tr>
</tbody>
</table>