聚合支付开放api


支付结果通知

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

页面列表

ITEM_HTML