招联对接文档


1.9 支付结果通知

<h4>请求地址</h4> <p><em>测试地址:</em> <code>商户请求所填notifyUrl</code></p> <p><em>正式地址:</em> <code>商户请求所填notifyUrl</code></p> <h4>场景说明</h4> <p>&gt;下单(主扫)交易的结果是以异步的形式进行回调的。招联在接收到上游支付通道的回调结果以后再回调商户。</p> <p><code>若在接收到招联回调之前发送了查询,并查到了交易的具体交易结果,招联则不再发送支付结果通知。商户接收回调成功处理成功后返回字符串&amp;quot;success&amp;quot;,则招联停止回调给商户。</code></p> <p><strong>重要!!! 重要!!! 重要!!!</strong>:<strong><code>不保证通知最终一定能成功</code></strong>,在订单状态不明或者没有收到支付结果通知的情况下,建议商户主动调用 [1.5 订单查询](<a href="https://www.showdoc.com.cn/jucaishangfu/9965825766680565">https://www.showdoc.com.cn/jucaishangfu/9965825766680565</a> &quot;1.5 订单查询&quot;) 确认订单状态 <code>条码支付没有异步通知</code></p> <p>回调形式:<code>json</code></p> <p>&gt;收到回调后直接在 body 里面获取json参数。</p> <h4>支付结果通知请求报文</h4> <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> <th style="text-align: left;">说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">req</td> <td style="text-align: left;">req</td> <td style="text-align: left;">body</td> <td style="text-align: left;">支付结果异步通知实体</td> </tr> <tr> <td style="text-align: left;">&amp;emsp;&amp;emsp;returnCode</td> <td style="text-align: left;">错误代码</td> <td style="text-align: left;"><code>true</code></td> <td style="text-align: left;">string</td> <td style="text-align: left;">0 成功,其他详细参见错误列表</td> </tr> <tr> <td style="text-align: left;">&amp;emsp;&amp;emsp;returnMsg</td> <td style="text-align: left;">错误代码描述</td> <td style="text-align: left;"><code>true</code></td> <td style="text-align: left;">string</td> </tr> <tr> <td style="text-align: left;">&amp;emsp;&amp;emsp;orgId</td> <td style="text-align: left;">机构号</td> <td style="text-align: left;">false</td> <td style="text-align: left;">string</td> </tr> <tr> <td style="text-align: left;">&amp;emsp;&amp;emsp;amount</td> <td style="text-align: left;">订单金额, 单位:分</td> <td style="text-align: left;"><code>true</code></td> <td style="text-align: left;">string</td> </tr> <tr> <td style="text-align: left;">&amp;emsp;&amp;emsp;buyerLogonId</td> <td style="text-align: left;">买家在渠道登录账号</td> <td style="text-align: left;">false</td> <td style="text-align: left;">string</td> </tr> <tr> <td style="text-align: left;">&amp;emsp;&amp;emsp;channelOrderId</td> <td style="text-align: left;">条码流水号</td> <td style="text-align: left;">false</td> <td style="text-align: left;">string</td> <td style="text-align: left;">用户账单二维码对应的流水</td> </tr> <tr> <td style="text-align: left;">&amp;emsp;&amp;emsp;couponFee</td> <td style="text-align: left;">优惠金额(分)</td> <td style="text-align: left;">false</td> <td style="text-align: left;">string</td> </tr> <tr> <td style="text-align: left;">&amp;emsp;&amp;emsp;currency</td> <td style="text-align: left;">货币代码</td> <td style="text-align: left;">false</td> <td style="text-align: left;">string</td> </tr> <tr> <td style="text-align: left;">&amp;emsp;&amp;emsp;dealDate</td> <td style="text-align: left;">交易日期,yyyyMMdd</td> <td style="text-align: left;">false</td> <td style="text-align: left;">string</td> </tr> <tr> <td style="text-align: left;">&amp;emsp;&amp;emsp;discountGoodsDetail</td> <td style="text-align: left;">商品优惠信息</td> <td style="text-align: left;">false</td> <td style="text-align: left;">string</td> <td style="text-align: left;">支付宝交易支付所使用的单品券优惠的商品优惠信息</td> </tr> <tr> <td style="text-align: left;">&amp;emsp;&amp;emsp;extParam</td> <td style="text-align: left;">商户扩展参数</td> <td style="text-align: left;">false</td> <td style="text-align: left;">string</td> </tr> <tr> <td style="text-align: left;">&amp;emsp;&amp;emsp;fundBillList</td> <td style="text-align: left;">支付宝交易资金渠道</td> <td style="text-align: left;">false</td> <td style="text-align: left;">string</td> <td style="text-align: left;">详细渠道</td> </tr> <tr> <td style="text-align: left;">&amp;emsp;&amp;emsp;hbIsSeller</td> <td style="text-align: left;">返回值</td> <td style="text-align: left;">false</td> <td style="text-align: left;">string</td> <td style="text-align: left;">1=商户出息</td> </tr> <tr> <td style="text-align: left;">&amp;emsp;&amp;emsp;isCredit</td> <td style="text-align: left;">false</td> <td style="text-align: left;">string</td> <td style="text-align: left;">1:表示信用卡或者花呗&lt;br&gt; 0:表示其他(非信用方式)&lt;br&gt; 不填,表示未知</td> </tr> <tr> <td style="text-align: left;">&amp;emsp;&amp;emsp;mchNo</td> <td style="text-align: left;">商户号</td> <td style="text-align: left;">false</td> <td style="text-align: left;">string</td> </tr> <tr> <td style="text-align: left;">&amp;emsp;&amp;emsp;mchOrderNo</td> <td style="text-align: left;">商户订单号</td> <td style="text-align: left;"><code>true</code></td> <td style="text-align: left;">string</td> <td style="text-align: left;">商户系统内部的订单号</td> </tr> <tr> <td style="text-align: left;">&amp;emsp;&amp;emsp;orderAmount</td> <td style="text-align: left;">应结订单金额</td> <td style="text-align: left;"><code>true</code></td> <td style="text-align: left;">string</td> <td style="text-align: left;">单位:分</td> </tr> <tr> <td style="text-align: left;">&amp;emsp;&amp;emsp;payTime</td> <td style="text-align: left;">支付完成时间</td> <td style="text-align: left;">false</td> <td style="text-align: left;">string</td> <td style="text-align: left;">格式为yyyyMMddHHmmss</td> </tr> <tr> <td style="text-align: left;">&amp;emsp;&amp;emsp;payType</td> <td style="text-align: left;">付款方式</td> <td style="text-align: left;">false</td> <td style="text-align: left;">string</td> </tr> <tr> <td style="text-align: left;">&amp;emsp;&amp;emsp;promotionDetail</td> <td style="text-align: left;">微信营销详情</td> <td style="text-align: left;">false</td> <td style="text-align: left;">string</td> </tr> <tr> <td style="text-align: left;">&amp;emsp;&amp;emsp;randomStr</td> <td style="text-align: left;">随机字符串</td> <td style="text-align: left;"><code>true</code></td> <td style="text-align: left;">string</td> </tr> <tr> <td style="text-align: left;">&amp;emsp;&amp;emsp;serviceChargeFlag</td> <td style="text-align: left;">手续费减免标识</td> <td style="text-align: left;">false</td> <td style="text-align: left;">string</td> <td style="text-align: left;">Y:表示减免(默认) N:表示不减免</td> </tr> <tr> <td style="text-align: left;">&amp;emsp;&amp;emsp;settlementAmt</td> <td style="text-align: left;">应结算订单金额</td> <td style="text-align: left;">false</td> <td style="text-align: left;">string</td> <td style="text-align: left;">只有成功交易才会返回 如果使用了商户免充值优惠券,该值为订单金额-商户免充值 如果没有使用商户免充值,该值等于订单金额</td> </tr> <tr> <td style="text-align: left;">&amp;emsp;&amp;emsp;termId</td> <td style="text-align: left;">终端号</td> <td style="text-align: left;">false</td> <td style="text-align: left;">string</td> </tr> <tr> <td style="text-align: left;">&amp;emsp;&amp;emsp;traceNo</td> <td style="text-align: left;">招联系统内部追踪号</td> <td style="text-align: left;">false</td> <td style="text-align: left;">string</td> </tr> <tr> <td style="text-align: left;">&amp;emsp;&amp;emsp;transactionId</td> <td style="text-align: left;">渠道订单号</td> <td style="text-align: left;"><code>true</code></td> <td style="text-align: left;">string</td> </tr> <tr> <td style="text-align: left;">&amp;emsp;&amp;emsp;userId</td> <td style="text-align: left;">用户在商户的id</td> <td style="text-align: left;">false</td> <td style="text-align: left;">string</td> </tr> <tr> <td style="text-align: left;">&amp;emsp;&amp;emsp;voucherDetailList</td> <td style="text-align: left;">优惠券信息</td> <td style="text-align: left;">false</td> <td style="text-align: left;">string</td> <td style="text-align: left;">支付宝交易支付时所使用的所有优惠券信息 &quot;[{&quot;amount&quot;:&quot;1.00&quot;,&quot;merchant_contribute&quot;:&quot;1.00&quot;, &quot;name&quot;:&quot;1.00元代金券&quot;,&quot;other_contribute&quot;:&quot;0.00&quot;, &quot;template_id&quot;:&quot;20221107000730017617007JGOUG&quot;, &quot;id&quot;:&quot;202211070007300282330EB2Y9QQ&quot;, &quot;type&quot;:&quot;ALIPAY_BIZ_VOUCHER&quot;}]&quot;</td> </tr> <tr> <td style="text-align: left;">&amp;emsp;&amp;emsp;wayCode</td> <td style="text-align: left;">支付方式</td> <td style="text-align: left;">false</td> <td style="text-align: left;">string</td> </tr> <tr> <td style="text-align: left;">&amp;emsp;&amp;emsp;sign</td> <td style="text-align: left;">签名串</td> <td style="text-align: left;"><code>true</code></td> <td style="text-align: left;">string</td> </tr> </tbody> </table> <h4>支付结果通知响应报文</h4> <p>&gt;<em>返回字符串:&quot;success&quot;</em></p> <h4>报文示例</h4> <p><em>请求报文</em></p> <pre><code class="language-json">{ &amp;quot;returnCode&amp;quot;: &amp;quot;0&amp;quot;, &amp;quot;returnMsg&amp;quot;: &amp;quot;SUCCESS&amp;quot;, &amp;quot;orgId&amp;quot;: &amp;quot;ISV_I238002400&amp;quot;, &amp;quot;amount&amp;quot;: &amp;quot;1&amp;quot;, &amp;quot;buyerLogonId&amp;quot;: &amp;quot;176****7885&amp;quot;, &amp;quot;channelOrderId&amp;quot;: &amp;quot;202303301518020724453&amp;quot;, &amp;quot;couponFee&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;currency&amp;quot;: &amp;quot;CNY&amp;quot;, &amp;quot;dealDate&amp;quot;: &amp;quot;20230330&amp;quot;, &amp;quot;discountGoodsDetail&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;extParam&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;fundBillList&amp;quot;: &amp;quot;[{\&amp;quot;amount\&amp;quot;:\&amp;quot;0.01\&amp;quot;,\&amp;quot;fund_channel\&amp;quot;:\&amp;quot;ALIPAYACCOUNT\&amp;quot;}]&amp;quot;, &amp;quot;isCredit&amp;quot;: &amp;quot;0&amp;quot;, &amp;quot;mchNo&amp;quot;: &amp;quot;MCH_I293975931&amp;quot;, &amp;quot;mchOrderNo&amp;quot;: &amp;quot;202303301518020724453&amp;quot;, &amp;quot;orderAmount&amp;quot;: &amp;quot;1&amp;quot;, &amp;quot;payTime&amp;quot;: &amp;quot;20230330145136&amp;quot;, &amp;quot;payType&amp;quot;: &amp;quot;ALIPAYACCOUNT&amp;quot;, &amp;quot;randomStr&amp;quot;: &amp;quot;8TQMOQGLUH65W952FVE28QQ9IXJQF9ZR&amp;quot;, &amp;quot;settlementAmt&amp;quot;: &amp;quot;1&amp;quot;, &amp;quot;termId&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;traceNo&amp;quot;: &amp;quot;030072224865&amp;quot;, &amp;quot;transactionId&amp;quot;: &amp;quot;2023033022001471591402023661&amp;quot;, &amp;quot;userId&amp;quot;: &amp;quot;2088802572771595&amp;quot;, &amp;quot;voucherDetailList&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;wayCode&amp;quot;: &amp;quot;ALIPAY&amp;quot;, &amp;quot;sign&amp;quot;: &amp;quot;61fe7cb17fe53f6fe433b38f0634ddb1&amp;quot; }</code></pre>

页面列表

ITEM_HTML