巨彩商服API


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;,则巨彩停止回调给商户。最多回调6次,每次间隔30S。</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>会通过此接口发异步通知,<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;">true</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;">true</td> <td style="text-align: left;">string</td> <td style="text-align: left;">200成功,其他详细参见错误列表</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;">true</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;">true</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;">true</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;">true</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;">true</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;">true</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;">true</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;">true</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;200&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> <p>&gt;请求报文签名原文</p> <pre><code>amount=1&amp;amp;buyerLogonId=176****7885&amp;amp;channelOrderId=202303301518020724453&amp;amp;currency=CNY&amp;amp;dealDate=20230330&amp;amp;fundBillList=[{&amp;quot;amount&amp;quot;:&amp;quot;0.01&amp;quot;,&amp;quot;fund_channel&amp;quot;:&amp;quot;ALIPAYACCOUNT&amp;quot;}]&amp;amp;isCredit=0&amp;amp;mchNo=MCH_I293975931&amp;amp;mchOrderNo=202303301518020724453&amp;amp;orderAmount=1&amp;amp;orgId=ISV_I238002400&amp;amp;payTime=20230330145136&amp;amp;payType=ALIPAYACCOUNT&amp;amp;randomStr=8TQMOQGLUH65W952FVE28QQ9IXJQF9ZR&amp;amp;returnCode=200&amp;amp;returnMsg=SUCCESS&amp;amp;settlementAmt=1&amp;amp;traceNo=030072224865&amp;amp;transactionId=2023033022001471591402023661&amp;amp;userId=2088802572771595&amp;amp;wayCode=ALIPAY&amp;amp;key=d0194c1024f180065d2434fa8b6a2f82</code></pre> <hr />

页面列表

ITEM_HTML