收呗

开放接口


提现异步通知

<p><strong>接口描述:</strong> </p> <ul> <li>在提现成功后,若提现时传入了bg_ret_url参数,则服务端会通过此接口通知商户端提现成功的结果。</li> <li>该接口的请求参数由服务端生成,返回参数是需要商户端响应的参数</li> </ul> <p><strong>接口URL:</strong> </p> <ul> <li>提现时的<code>bg_ret_url</code>参数</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;">inst_no</td> <td style="text-align: center;">string(8)</td> <td style="text-align: center;">是</td> <td style="text-align: left;">机构号</td> <td>900024</td> </tr> <tr> <td style="text-align: left;">merchant_no</td> <td style="text-align: center;">string(32)</td> <td style="text-align: center;">是</td> <td style="text-align: left;">收呗商户号</td> <td>851902260011</td> </tr> <tr> <td style="text-align: left;">terminal_no</td> <td style="text-align: center;">string(80)</td> <td style="text-align: center;">终端号</td> </tr> <tr> <td style="text-align: left;">withdraw_trace_no</td> <td style="text-align: center;">string(32)</td> <td style="text-align: center;">是</td> <td style="text-align: left;">提现流水号</td> <td>51c7d68424e5492199cf7f4734a2b977</td> </tr> <tr> <td style="text-align: left;">withdraw_time</td> <td style="text-align: center;">string(50)</td> <td style="text-align: center;">是</td> <td style="text-align: left;">提现时间yyyyMMddHHmmss</td> <td>20200406011919</td> </tr> <tr> <td style="text-align: left;">out_withdraw_no</td> <td style="text-align: center;">string(64)</td> <td style="text-align: center;">是</td> <td style="text-align: left;">收呗唯一提现订单号</td> <td>20000002814118090716435200001</td> </tr> <tr> <td style="text-align: left;">cash_out</td> <td style="text-align: center;">string(64)</td> <td style="text-align: center;">是</td> <td style="text-align: left;">提现金额(分)</td> <td>100</td> </tr> <tr> <td style="text-align: left;">rel_cash_out</td> <td style="text-align: center;">string(64)</td> <td style="text-align: center;">是</td> <td style="text-align: left;">实际提现金额(分)</td> <td>100</td> </tr> <tr> <td style="text-align: left;">cash_out_fee</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;">channel_withdraw_no</td> <td style="text-align: center;">string(8)</td> <td style="text-align: center;">是</td> <td style="text-align: left;">通道提现订单号</td> <td>1234567890</td> </tr> <tr> <td style="text-align: left;">end_time</td> <td style="text-align: center;">string(64)</td> <td style="text-align: center;">是</td> <td style="text-align: left;">提现完成时间yyyy-MM-dd HH:mm:ss</td> <td>2020-04-06 01:21:20</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">{ "return_code": "SUCCESS", "return_msg": "提现成功", "result_code": "PAY_SUCCESS", "inst_no": "900052", "merchant_no": "851902260011", "terminal_no": "", "withdraw_trace_no": "51c7d68424e5492199cf7f4734a2b977", "withdraw_time": "20200406011919", "out_withdraw_no": "20000002814118090716435200001", "cash_out": "100", "rel_cash_out": "100", "cash_out_fee": "1", "channel_withdraw_no": "1234567890", "end_time": "2020-04-06 01:21:20", "sign": "91268292cf08403da47b3eefb4e2f941" }</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">{ "return_code": "SUCCESS", "return_msg": "成功" }</code></pre>

页面列表

ITEM_HTML