乐收赢API

银飞乐收赢接口文档


退款

<p><strong>接口描述:</strong> </p> <ul> <li>通用退款接口,可用于扫码支付(付款码支付、二维码支付),JSAPI支付,聚合支付等退款</li> </ul> <p><strong>接口URL:</strong> 测试 <code>https://test.gdyfsk.com/yfpay/scaniot/qm50s/refund</code></p> <p><strong>请求方式:</strong></p> <ul> <li>POST </li> </ul> <p><strong>请求头部:</strong></p> <table> <thead> <tr> <th style="text-align: left;">标签</th> <th style="text-align: left;">必填</th> <th>内容</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">Content-Type</td> <td style="text-align: left;">是</td> <td>application/x-www-form-urlencoded</td> </tr> </tbody> </table> <p><strong>请求参数:</strong> </p> <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>参数示例</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">inst_no</td> <td style="text-align: left;">string(8)</td> <td style="text-align: left;">M</td> <td style="text-align: left;">乐收赢机构号</td> <td>900075</td> </tr> <tr> <td style="text-align: left;">terminal_no</td> <td style="text-align: left;">string(32)</td> <td style="text-align: left;">M</td> <td style="text-align: left;">乐收赢终端号</td> <td>70020283</td> </tr> <tr> <td style="text-align: left;">refund_trace_no</td> <td style="text-align: left;">string(64)</td> <td style="text-align: left;">M</td> <td style="text-align: left;">退款请求流水号</td> <td>31dafada31dskcada</td> </tr> <tr> <td style="text-align: left;">refund_fee</td> <td style="text-align: left;">string(8)</td> <td style="text-align: left;">M</td> <td style="text-align: left;">退款金额,单位:分</td> <td>100</td> </tr> <tr> <td style="text-align: left;">trade_no</td> <td style="text-align: left;">string(64)</td> <td style="text-align: left;">C</td> <td style="text-align: left;">原订单号,trade_no与pay_trace_no二选一必传</td> <td>20000032114018111516011200013</td> </tr> <tr> <td style="text-align: left;">pay_trace_no</td> <td style="text-align: left;">String(64)</td> <td style="text-align: left;">C</td> <td style="text-align: left;">原支付请求流水号,trade_no与pay_trace_no二选一必传</td> <td>20000032114018111516011200013</td> <td>201908050956210001</td> </tr> <tr> <td style="text-align: left;">sign</td> <td style="text-align: left;">string(32)</td> <td style="text-align: left;">M</td> <td style="text-align: left;">签名</td> <td>51c7d68424e5492199cf7f4734a2b977</td> </tr> </tbody> </table> <p><strong>请求示例:</strong></p> <p><a href="https://test.gdyfsk.com/yfpay/scaniot/qm50s/refund?inst_no=900376&amp;terminal_no=70005338&amp;refund_trace_no=202407211531513220711&amp;refund_fee=1&amp;trade_no=200001962G3124120511545550001&amp;auth_code=123456&amp;sign=1d070928b628444a0e2a10e551164154">https://test.gdyfsk.com/yfpay/scaniot/qm50s/refund?inst_no=900376&amp;terminal_no=70005338&amp;refund_trace_no=202407211531513220711&amp;refund_fee=1&amp;trade_no=200001962G3124120511545550001&amp;auth_code=123456&amp;sign=1d070928b628444a0e2a10e551164154</a></p> <pre><code class="language-json">{     &amp;quot;inst_no&amp;quot;: &amp;quot;900376&amp;quot;,     &amp;quot;terminal_no&amp;quot;: &amp;quot;70005338&amp;quot;,     &amp;quot;refund_trace_no&amp;quot;: &amp;quot;202407211531513220711&amp;quot;,     &amp;quot;refund_fee&amp;quot;: &amp;quot;1&amp;quot;,     &amp;quot;trade_no&amp;quot;: &amp;quot;200001962G3124120511545550001&amp;quot;,     &amp;quot;auth_code&amp;quot;: &amp;quot;123456&amp;quot;,     &amp;quot;sign&amp;quot;: &amp;quot;4f76aaa200018f0e32cc205934977b00&amp;quot; }</code></pre> <p><strong>返回参数:</strong> </p> <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>参数示例</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">return_code</td> <td style="text-align: left;">string(32)</td> <td style="text-align: left;">是</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: left;">string(128)</td> <td style="text-align: left;">是</td> <td style="text-align: left;">返回信息提示,“支付成功”,“支付中”,“参数不合法” 等</td> <td>支付成功</td> </tr> </tbody> </table> <ul> <li>以下参数在<code>return_code</code>为<code>SUCCESS</code>时返回</li> </ul> <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>参数示例</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">result_code</td> <td style="text-align: left;">string(32)</td> <td style="text-align: left;">是</td> <td style="text-align: left;">业务结果:PAY_SUCCESS退款成功,PAY_FAIL退款失败,PAY_IN_PROCESS退款申请中,退款申请中需调用<a href="https://www.showdoc.cc/shoubei?page_id=3336131192761854">退款查询接口</a>确认退款结果</td> <td>PAY_SUCCESS</td> </tr> <tr> <td style="text-align: left;">mch_no</td> <td style="text-align: left;">string(32)</td> <td style="text-align: left;">是</td> <td style="text-align: left;">商户号</td> <td>Y52211090004</td> </tr> <tr> <td style="text-align: left;">shop_no</td> <td style="text-align: left;">string(32)</td> <td style="text-align: left;"></td> <td style="text-align: left;">门店号</td> <td>86000033007</td> </tr> <tr> <td style="text-align: left;">mch_name</td> <td style="text-align: left;">string(80)</td> <td style="text-align: left;">是</td> <td style="text-align: left;">商户名称</td> <td>休休4D</td> </tr> <tr> <td style="text-align: left;">shop_name</td> <td style="text-align: left;">string(50)</td> <td style="text-align: left;"></td> <td style="text-align: left;">门店名称</td> <td>1号店</td> </tr> <tr> <td style="text-align: left;">refund_trace_no</td> <td style="text-align: left;">string(64)</td> <td style="text-align: left;">是</td> <td style="text-align: left;">退款请求流水号,系统原样返回</td> <td>113332313422343003</td> </tr> <tr> <td style="text-align: left;">refund_fee</td> <td style="text-align: left;">string(8)</td> <td style="text-align: left;">是</td> <td style="text-align: left;">退款金额,单位:分,有优惠时返回实退金额</td> <td>100</td> </tr> <tr> <td style="text-align: left;">pay_type</td> <td style="text-align: left;">string(3)</td> <td style="text-align: left;">是</td> <td style="text-align: left;">支付类型:300支付宝,400微信,900.龙支付</td> <td>300</td> </tr> <tr> <td style="text-align: left;">pay_time</td> <td style="text-align: left;">string(14)</td> <td style="text-align: left;">是</td> <td style="text-align: left;">退款请求时间,yyyyMMddHHmmss</td> <td>20180907175853</td> </tr> <tr> <td style="text-align: left;">end_time</td> <td style="text-align: left;">string(14)</td> <td style="text-align: left;"></td> <td style="text-align: left;">支付完成时间,yyyyMMddHHmmss</td> <td>20180907175853</td> </tr> <tr> <td style="text-align: left;">qd_refund_no</td> <td style="text-align: left;">string(64)</td> <td style="text-align: left;"></td> <td style="text-align: left;">渠道退款订单号</td> <td></td> </tr> <tr> <td style="text-align: left;">refund_no</td> <td style="text-align: left;">string(64)</td> <td style="text-align: left;">是</td> <td style="text-align: left;">退款单号</td> <td>20000002824018090717585100001</td> </tr> <tr> <td style="text-align: left;">sign</td> <td style="text-align: left;">string(32)</td> <td style="text-align: left;">是</td> <td style="text-align: left;">签名字符串</td> <td>51c7d68424e5492199cf7f4734a2b977</td> </tr> </tbody> </table> <p><strong>返回示例:</strong> </p> <ul> <li>退款成功返回:</li> </ul> <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;, &amp;quot;result_code&amp;quot;:&amp;quot;PAY_SUCCESS&amp;quot;, &amp;quot;mch_name&amp;quot;: &amp;quot;一休支付宝N7H测试&amp;quot;,     &amp;quot;mch_no&amp;quot;: &amp;quot;852406170001&amp;quot;,     &amp;quot;pay_time&amp;quot;: &amp;quot;20241205122710&amp;quot;,     &amp;quot;pay_type&amp;quot;: &amp;quot;300&amp;quot;,     &amp;quot;qd_refund_no&amp;quot;: &amp;quot;002900TOP2A241205115456P017ac139cfc00000&amp;quot;,     &amp;quot;refund_fee&amp;quot;: &amp;quot;1&amp;quot;,     &amp;quot;refund_no&amp;quot;: &amp;quot;200001962G3024120512271020001&amp;quot;,     &amp;quot;refund_trace_no&amp;quot;: &amp;quot;202407211531513220711&amp;quot;,     &amp;quot;result_code&amp;quot;: &amp;quot;PAY_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; } </code></pre>

页面列表

ITEM_HTML