支付结果通知
<h5>支付结果通知</h5>
<ul>
<li>用户支付后,微保将支付结果通知给商户,商户需根据支付状态进行下一步处理。</li>
<li><font style="color:red;">同一笔交易如收到多次通知,商户对接时需要做好幂等处理,防止重复通知出现问题。</font></li>
<li>通知策略:收到微保回调通知需回写大写OK ,如没有回写则最多通知10次,10次后没有拿到回写则停止通知。</li>
<li><font style="color:red;">网银支付,需要校验账户信息时,需通过checkStatus获取校验结果。</font></li>
</ul>
<h5>请求URL</h5>
<ul>
<li>服务端异步通知商户的接口地址对应统一下单接口的参数为:notifyUrl,该接口地址由商户提供。</li>
</ul>
<h5>请求方式</h5>
<ul>
<li>POST </li>
</ul>
<h5>参数</h5>
<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;">customerNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(32)</td>
<td>商户号 <br><span style="color:#F00">示例:202112090603</td>
</tr>
<tr>
<td style="text-align: left;">orderNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(64)</td>
<td>商户订单号 <br><span style="color:#F00">示例:202209070002</td>
</tr>
<tr>
<td style="text-align: left;">goodNo</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(32)</td>
<td>商品编码 <br><span style="color:#F00">示例:ONEQRCODE</td>
</tr>
<tr>
<td style="text-align: left;">goodName</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(64)</td>
<td>商品名称 <br><span style="color:#F00">示例:test</td>
</tr>
<tr>
<td style="text-align: left;">serialNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(32)</td>
<td>支付流水号,对应平台流水号 <br><span style="color:#F00">示例:S1567327155606323298</td>
</tr>
<tr>
<td style="text-align: left;">orderAmount</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Long(11)</td>
<td>订单金额,以分为单位 <br><span style="color:#F00">示例:1</td>
</tr>
<tr>
<td style="text-align: left;">payType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(32)</td>
<td>支付方式 <br>WECHAT_JSAPI:公众号支付 <br>ALIPAY_SCAN:支付宝扫码 <br>ALIPAY_LIFE:支付宝生活号 <br>ALIPAY_H5:支付宝H5<br>ALIPAY_APP:支付宝APP<br>UNION_JSPAY:银联云闪付 <br>BANKTRANSFERPAY:银行转账 <br>B2B:对公网银支付 <br>B2C:个人网银支付 <br>ICBC_EPAY:新直连收单-工商银行<br>CMB_EPAY:新直连收单-招商银行<br>ABC_EPAY:新直连收单-农业银行<br>JDPAY_H5WALLET:京东钱包<br>JDPAY_H5CREDIT:京东白条<br><span style="color:#F00">示例:WECHAT_JSAPI</td>
</tr>
<tr>
<td style="text-align: left;">identifyId</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(64)</td>
<td>用户标识,微信openId 支付宝、银联云闪付userId <br><span style="color:#F00">示例:o2O6gt8QJYry9JEyL1zhr0WuGdoo</td>
</tr>
<tr>
<td style="text-align: left;">payTime</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>支付时间 yyyy-MM-dd HH:mm:ss <br><span style="color:#F00">示例:2022-09-07 09:41:58</td>
</tr>
<tr>
<td style="text-align: left;">payStatus</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(11)</td>
<td><strong>支付状态</strong> <br>WAITPAY:待支付<br> PROCESSING:订单支付中<br>SUCCESS:订单支付成功<br>TIME_OUT:订单已过期<br>FAIL:订单支付失败<br>CLOSE:订单关闭 <br><span style="color:#F00">示例:SUCCESS</td>
</tr>
<tr>
<td style="text-align: left;">checkStatus</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(11)</td>
<td><strong>网银支付账户校验状态 <br><span style="color:#F00">默认为: CLOSE</span> </strong> <br>SUCCESS:校验成功<br>FAIL:校验失败 <br>CLOSE:不校验 <br> PROCESSING:结果未知<br><span style="color:#F00"> 示例:SUCCESS</td>
</tr>
<tr>
<td style="text-align: left;">checkMsg</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(64)</td>
<td><strong>网银支付账户校验结果描述 <br><span style="color:#F00">默认为: 不校验 </strong> <br>SUCCESS:校验成功<br>FAIL:户名不符/卡号不符/手机号不符<br>CLOSE:不校验 <br> PROCESSING:结果未知<br><span style="color:#F00"> 示例:户名不符</td>
</tr>
<tr>
<td style="text-align: left;">channelReturnSeq</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(64)</td>
<td>渠道订单号<br>该笔订单在微信、支付宝、银联云闪付或银行侧系统生成的单号 <br><span style="color:#F00">示例:4200001615202209072973882680</td>
</tr>
<tr>
<td style="text-align: left;">channelBankSeq</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(64)</td>
<td>银行订单号<br>支付机构在银网联侧的单号,该单号也是支付机构在微信支付宝、银联云闪付侧的外部商户订单号 <br>使用场景:服务商用于点金计划商户小票功能 <br><span style="color:#F00">示例:5515880892220970</td>
</tr>
<tr>
<td style="text-align: left;">ext1</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(512)</td>
<td>附加数据,原样返回</td>
</tr>
<tr>
<td style="text-align: left;">ext2</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(512)</td>
<td>附加数据,原样返回</td>
</tr>
<tr>
<td style="text-align: left;">channelCode</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(64)</td>
<td>渠道编码 <br>Yeepay_MP:易宝支付 <br>ICBC:工商银行 <br>ICBC_SH:工商银行上海分行 <br>cmb_pay:招商银行</td>
</tr>
<tr>
<td style="text-align: left;">payerInfo</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">object</td>
<td>付款信息,网银支付时返回 <br><span style="color:#F00">示例:{“bankId”:”CMBCHINA”,”bankCardNo”:””,”mobilePhoneNo”:””,”cardType”:”DEBIT”}</td>
</tr>
<tr>
<td style="text-align: left;">payeeInfo</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">object</td>
<td>收款信息,转账支付时返回 <br><span style="color:#F00">示例:{"payeeAccName":"微保科技","payeeBankName":"民生银行","payeeAccNo":"9902000306335449"}</td>
</tr>
<tr>
<td style="text-align: left;">installmentData</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">object</td>
<td>分期数据,京东白条支付时返回 <br><span style="color:#F00">示例:{"installmentNum":"1"}</td>
</tr>
</tbody>
</table>
<h6>payerInfo信息</h6>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">bankId</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(11)</td>
<td>银行编号</td>
<td>ABC</td>
</tr>
<tr>
<td style="text-align: left;">bankCardNo</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(32)</td>
<td>银行卡号 掩码返回前6后4</td>
<td>622848****0000</td>
</tr>
<tr>
<td style="text-align: left;">accountName</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(64)</td>
<td>账户名称 付款账户名称,最长42个汉字。网银B2B支付返回付款企业账户名称</td>
<td>微保科技</td>
</tr>
<tr>
<td style="text-align: left;">mobilePhoneNo</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(11)</td>
<td>手机号 掩码返回,显示前3后4</td>
<td>138****0000</td>
</tr>
<tr>
<td style="text-align: left;">cardType</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(11)</td>
<td>卡类型 DEBIT:借记卡CREDIT:贷记卡</td>
<td>DEBIT</td>
</tr>
</tbody>
</table>
<h6>payeeInfo信息</h6>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">payeeAccName</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(64)</td>
<td>收款户名</td>
<td>微保科技</td>
</tr>
<tr>
<td style="text-align: left;">payeeBankName</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(64)</td>
<td>收款银行</td>
<td>民生银行</td>
</tr>
<tr>
<td style="text-align: left;">payeeAccNo</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(64)</td>
<td>收款账号</td>
<td>9902000306335449</td>
</tr>
</tbody>
</table>
<h6>installmentData信息</h6>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
<th>示例</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">installmentNum</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(8)</td>
<td>分期数</td>
<td>1</td>
</tr>
</tbody>
</table>
<h5>请求报文示例</h5>
<pre><code>{&quot;code&quot;:&quot;200&quot;,&quot;success&quot;:true,&quot;data&quot;:&quot;{\&quot;customerNo\&quot;:\&quot;202112090603\&quot;,\&quot;reqmsg\&quot;:\&quot;kdlGh3uEZM5gEgpD/pDIVOeRMKxKwZxv6wVeUnFGBnSXNqqh77SZ9SiCWnhGm6qm6LMRcjKGIRkhg+9F13kZUcjj6+N1giE3I/WvH0AedTV69ZzgQujucov8wE4D7iuyRupc06Sl8i8wgl4NkWEQ+SS50doePETV2chXzK6QaWJ0Mq820VQRtQFwp23b+XXTU/CSdjP0DR7cJ5Sh2iFbUeJfHutgO0E84dXngJI3NVL0QeJdcCgC37w1JtaJKHTzFAP66dR/fmWCtff+JEBNVINbZ15ZJKEKYmsxZmWXMZgyNlFWtRloVEQUhytPbz/GPdJFaGZDx5YnmTXrHwKgZhxcPfyQ+k54EgUdZzJEyCiuXq7dXYKoSu5cule5kyAk22RDjLeaVWsf6wA6dXG+vXkllQ2Nb1cOecYSRdJo1NyyH7ERDX7rcywdPWV5K3XYkL3JCU8N3RpjSLOtotvop1/HY8O2/35KPX68LCvsBRCaydehAlXOtaFycunuMkkkBM8bNgQ0R9iHj5MU+4mzl0IvzaXgBoZupMYcK8BVibUj3rmV5JLYVrk6q4x/oqaSX63wNqH/mlTZ8OlDhuISUce7EkmwLnSew/Sfb6ImlFhKUSNG4uevfkyfyNnhzydF1K0Qa0zYCx7fgN2UgIZAnibQcJuOl8YlH7GT7cciZGY=\&quot;}&quot;,&quot;msg&quot;:&quot;操作成功&quot;}
reqmsg明文:
{
&quot;customerNo&quot;: &quot;202112090603&quot;,
&quot;orderNo&quot;: &quot;202209070002&quot;,
&quot;goodName&quot;: &quot;test&quot;,
&quot;serialNo&quot;: &quot;S1567327155606323280&quot;,
&quot;orderAmount&quot;: &quot;1&quot;,
&quot;payType&quot;: &quot;WECHAT_JSAPI&quot;,
&quot;identifyId&quot;: &quot;o2O6gt8QJYry9JEyL1zhr0WuGdoo&quot;,
&quot;payTime&quot;: &quot;2022-09-07 09:41:58&quot;,
&quot;payStatus&quot;: &quot;SUCCESS&quot;,
&quot;channelReturnSeq&quot;: &quot;4200001615202209072973882680&quot;,
&quot;channelBankSeq&quot;: &quot;5515880892220970&quot;,
&quot;payerInfo&quot;: &quot;{}&quot;,
&quot;sign&quot;: &quot;C3CD19868F5728B4E7475DB950DD9E73&quot;
}</code></pre>
<h5>返回参数说明</h5>
<p>返回信息只能定义为OK(必须为大写英文字母),如返回其他信息均为失败。如失败,反复调用该接口。</p>
<h5>商户响应示例</h5>
<pre><code>OK</code></pre>
<h5>备注</h5>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>