乐收赢API

银飞乐收赢接口文档


退款异步回调

<p><strong>接口描述:</strong> </p> <ul> <li>对于各类预先生成支付订单(C扫B,公众号支付,小程序支付,聚合码支付等)的支付方式,在订单支付成功后,进行退款,并且退款成功,若下单时传入了notify_url参数,则服务端会通过此接口通知商户端支付成功的结果,也可通过联系运营同学配置对应回调地址。</li> <li>该接口的请求参数由服务端生成,返回参数是需要商户端响应的参数。</li> <li>有可能重复通知,商户后台系统需要做幂等处理,避免重复发货。</li> <li>如果接收到回调,需要返回接收成功,否则乐收赢会一直通知。</li> </ul> <p><strong>接口URL:</strong> </p> <ul> <li>支付请求中的<code>notify_url</code>参数</li> <li>运营同学配置的回调地址</li> </ul> <p><strong>请求方式:</strong></p> <ul> <li>POST</li> </ul> <p><strong>请求头部:</strong></p> <table> <thead> <tr> <th>标签</th> <th>必填</th> <th>内容</th> </tr> </thead> <tbody> <tr> <td>Content-Type</td> <td>是</td> <td>application/json</td> </tr> </tbody> </table> <p><strong>请求参数:</strong> </p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: center;">类型</th> <th style="text-align: center;">必填</th> <th style="text-align: left;">说明</th> <th>参数示例</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">return_code</td> <td style="text-align: center;">string(32)</td> <td style="text-align: center;">是</td> <td style="text-align: left;">响应码:SUCCESS成功,FAIL失败,响应码仅代表通信状态,不代表业务结果</td> <td>SUCCESS</td> </tr> <tr> <td style="text-align: left;">return_msg</td> <td style="text-align: center;">string(128)</td> <td style="text-align: center;">是</td> <td style="text-align: left;">返回信息提示,“支付成功”等</td> <td>支付成功</td> </tr> <tr> <td style="text-align: left;">result_code</td> <td style="text-align: center;">string(32)</td> <td style="text-align: center;">是</td> <td style="text-align: left;">支付成功:PAY_SUCCESS成功 ,PAY_FAIL失败</td> <td>PAY_SUCCESS</td> </tr> <tr> <td style="text-align: left;">pay_type</td> <td style="text-align: center;">string(3)</td> <td style="text-align: center;">是</td> <td style="text-align: left;">支付类型,300支付宝,400微信,900.龙支付</td> <td>400</td> </tr> <tr> <td style="text-align: left;">pay_trace_no</td> <td style="text-align: center;">string(64)</td> <td style="text-align: center;">是</td> <td style="text-align: left;">请求支付流水号</td> <td>19988763891732480</td> </tr> <tr> <td style="text-align: left;">pay_time</td> <td style="text-align: center;">string(14)</td> <td style="text-align: center;">是</td> <td style="text-align: left;">请求支付时间</td> <td>20190527174740</td> </tr> <tr> <td style="text-align: left;">end_time</td> <td style="text-align: center;">string(32)</td> <td style="text-align: center;">支付完成时间</td> <td style="text-align: left;">yyyyMMddHHmmss</td> </tr> <tr> <td style="text-align: left;">inst_no</td> <td style="text-align: center;">string(8)</td> <td style="text-align: center;">是</td> <td style="text-align: left;">机构号</td> <td>900075</td> </tr> <tr> <td style="text-align: left;">mch_no</td> <td style="text-align: center;">string(32)</td> <td style="text-align: center;">是</td> <td style="text-align: left;">商户号</td> <td>Y52211090004</td> </tr> <tr> <td style="text-align: left;">mch_name</td> <td style="text-align: center;">string(80)</td> <td style="text-align: center;">是</td> <td style="text-align: left;">商户名称</td> <td>银飞测试</td> </tr> <tr> <td style="text-align: left;">shop_no</td> <td style="text-align: center;">string(32)</td> <td style="text-align: center;">门店号</td> <td style="text-align: left;">861902260012</td> </tr> <tr> <td style="text-align: left;">shop_name</td> <td style="text-align: center;">string(50)</td> <td style="text-align: center;">门店名称</td> <td style="text-align: left;">糖糖小店</td> </tr> <tr> <td style="text-align: left;">trade_no</td> <td style="text-align: center;">string(64)</td> <td style="text-align: center;">是</td> <td style="text-align: left;">唯一订单号</td> <td>20000131214619052717474113721</td> </tr> <tr> <td style="text-align: left;">td_trade_no</td> <td style="text-align: center;">string(64)</td> <td style="text-align: center;">通道订单号,微信订单号、支付宝订单号等</td> <td style="text-align: left;">4200000337201905279610829271</td> </tr> <tr> <td style="text-align: left;">qd_trade_no</td> <td style="text-align: center;">string(64)</td> <td style="text-align: center;">渠道订单号,各支付渠道银行机构订单号</td> <td style="text-align: left;">MYBKJHZF2019052717474162270360</td> </tr> <tr> <td style="text-align: left;">total_amount</td> <td style="text-align: center;">string(8)</td> <td style="text-align: center;">是</td> <td style="text-align: left;">金额,单位(分)</td> <td>1</td> </tr> <tr> <td style="text-align: left;">receipt_amount</td> <td style="text-align: center;">string(8)</td> <td style="text-align: center;">口碑实收金额</td> <td style="text-align: left;">-1</td> </tr> <tr> <td style="text-align: left;">pay_amount</td> <td style="text-align: center;">string(8)</td> <td style="text-align: center;">用户实付</td> <td style="text-align: left;">-1</td> </tr> <tr> <td style="text-align: left;">coupon_amount</td> <td style="text-align: center;">string(8)</td> <td style="text-align: center;">商家优惠金额</td> <td style="text-align: left;">-1</td> </tr> <tr> <td style="text-align: left;">discount_amount</td> <td style="text-align: center;">string(8)</td> <td style="text-align: center;">平台优惠金额</td> <td style="text-align: left;">-1</td> </tr> <tr> <td style="text-align: left;">user_id</td> <td style="text-align: center;">string(64)</td> <td style="text-align: center;">用户id(微信openid,支付宝userid)</td> <td style="text-align: left;">odpmp5Y-AmAMgPE1alyynzngzfTg</td> </tr> <tr> <td style="text-align: left;">attach</td> <td style="text-align: center;">string(128)</td> <td style="text-align: center;">附加数据,原样返回</td> </tr> <tr> <td style="text-align: left;">o_trade_no</td> <td style="text-align: center;">string(64)</td> <td style="text-align: center;">交易原订单,退款回调时返回 2024-12-24 新增</td> </tr> <tr> <td style="text-align: left;">trade_type</td> <td style="text-align: center;">string(2)</td> <td style="text-align: center;">订单通知类型0-退款 1-交易 2024-12-24 新增</td> </tr> <tr> <td style="text-align: left;">sign</td> <td style="text-align: center;">string(32)</td> <td style="text-align: center;">是</td> <td style="text-align: left;">签名</td> <td>91268292cf08403da47b3eefb4e2f941</td> </tr> </tbody> </table> <p><strong>请求示例:</strong></p> <pre><code class="language-json"> { &amp;quot;attach&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;coupon_amount&amp;quot;: &amp;quot;0&amp;quot;, &amp;quot;discount_amount&amp;quot;: &amp;quot;0&amp;quot;, &amp;quot;end_time&amp;quot;: &amp;quot;20241224144815&amp;quot;, &amp;quot;inst_no&amp;quot;: &amp;quot;xxxx&amp;quot;, &amp;quot;mch_name&amp;quot;: &amp;quot;测试专用&amp;quot;, &amp;quot;mch_no&amp;quot;: &amp;quot;xxx&amp;quot;, &amp;quot;o_trade_no&amp;quot;: &amp;quot;xxx&amp;quot;, &amp;quot;pay_amount&amp;quot;: &amp;quot;-1&amp;quot;, &amp;quot;pay_time&amp;quot;: &amp;quot;20241224144541&amp;quot;, &amp;quot;pay_trace_no&amp;quot;: &amp;quot;e3b815d065ef48ff82dd22460510702d&amp;quot;, &amp;quot;pay_type&amp;quot;: &amp;quot;400&amp;quot;, &amp;quot;qd_trade_no&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;receipt_amount&amp;quot;: &amp;quot;-1&amp;quot;, &amp;quot;result_code&amp;quot;: &amp;quot;TRADE_REFUND&amp;quot;, &amp;quot;return_code&amp;quot;: &amp;quot;SUCCESS&amp;quot;, &amp;quot;return_msg&amp;quot;: &amp;quot;退款成功&amp;quot;, &amp;quot;shop_name&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;shop_no&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;sign&amp;quot;: &amp;quot;51dfe426c557b7de18a8b24d397ccfbe&amp;quot;, &amp;quot;td_trade_no&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;total_amount&amp;quot;: &amp;quot;1&amp;quot;, &amp;quot;trade_no&amp;quot;: &amp;quot;xxx&amp;quot;, &amp;quot;trade_type&amp;quot;: &amp;quot;0&amp;quot;, &amp;quot;user_id&amp;quot;: &amp;quot;xxx&amp;quot; }</code></pre> <p><strong>返回参数:</strong></p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: center;">类型</th> <th style="text-align: center;">必填</th> <th style="text-align: left;">说明</th> <th>参数示例</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">return_code</td> <td style="text-align: center;">string(32)</td> <td style="text-align: center;">是</td> <td style="text-align: left;">SUCCESS接收成功,FAIL接收失败</td> <td>SUCCESS</td> </tr> <tr> <td style="text-align: left;">return_msg</td> <td style="text-align: center;">string(128)</td> <td style="text-align: center;">是</td> <td style="text-align: left;">返回信息提示,“支付成功”等</td> <td>成功</td> </tr> </tbody> </table> <p><strong>返回示例:</strong></p> <pre><code class="language-json">{ &amp;quot;return_code&amp;quot;: &amp;quot;SUCCESS&amp;quot;, &amp;quot;return_msg&amp;quot;: &amp;quot;成功&amp;quot; }</code></pre>

页面列表

ITEM_HTML