HuiPay-development_one

开发中的文档


支付退款

<h5>简要描述</h5> <ul> <li> <p>当您的业务需要发起退款时,资金会原路退回用户的支付宝或微信中。 支持一次全额或多次部分退款,退款次数最多不超过10次。多次部分退款时,当前退款金额 + 已退款金额不能大于原支付金额。 </p> </li> <li><a href='https://www.showdoc.com.cn/p/771ffd5460dbefeed31e5f7e5b402fbb'>异步通知</a></li> </ul> <h5>请求URL</h5> <ul> <li><code>https://pay.bjtdba.com/v1/HuiPay/Payment_refund</code></li> </ul> <h5>请求方式</h5> <ul> <li>POST </li> </ul> <h5>参数</h5> <table> <thead> <tr> <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;">union_id</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>用户id 在平台注册后产生的用户唯一标识</td> </tr> <tr> <td style="text-align: left;">id</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>当支付确认成功后进行退款,请传入支付确认对象的id;当实时分账成功后进行退款,请传入支付对象的id。</td> </tr> <tr> <td style="text-align: left;">refund_order_no</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>请求订单号,只能为英文、数字或者下划线的一种或多种组合</td> </tr> <tr> <td style="text-align: left;">refund_amt</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>退款金额,若退款金额小于原交易金额,则认为是部分退款,必须大于0,保留两位小数点,如0.10、100.05等</td> </tr> <tr> <td style="text-align: left;">div_members</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String</td> <td>分账对象信息列表,json 形式,详见 分账对象信息列表 ;若原交易对象未分账,则创建退款对象时,该字段不传;若原交易对象分账,则退款分账对象必须在原交易参与的分账方范围内,分账对象列表内的总金额必须等于退款金额,每个分账对象的退分账金额必须满足:退分账金额+已退分账金额 &lt;= 原交易分账对象的分账金额。</td> </tr> <tr> <td style="text-align: left;">reason</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String</td> <td>退款描述</td> </tr> <tr> <td style="text-align: left;">notify_url</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String</td> <td>异步通知地址</td> </tr> <tr> <td style="text-align: left;">api_key</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String</td> <td>api_key</td> </tr> </tbody> </table> <h5>请求示例</h5> <pre><code>{ "id":"002112021112409414396307008831488", "refund_order_no":"refund_order_20211124095119231339", "refund_amt":"0.01", "div_members":"[{"member_id":0,"amount":"0.01","fee_flag":"Y"}]", "reason":"与客户协商一致,退款!", "notify_url":"pay39.cn/tsw/test", "api_key":"api_live_d955-5ba-4abc-4a7-ec0574a2456" }</code></pre> <h5>返回示例</h5> <pre><code> { "code":200, "message":"success", "data":{ "object":"refund", "status":"pending", "id":"00211201124100333980309401800189452288", "refund_order_no":"refund_order_20211124100332605726", "payment_id":"0021120211124100139101322662965248", "payment_order_no":"payment_create_20211124100139287587", "refund_amt":"0.01", "fee_amt":"0.00", "channel_no":"2021112421R8vhcp", "created_time":"1637719414000", "succeed_time":"1637719414000", "app_id":"app_bd46cc29-6b1-a70f-65187485f468" } }</code></pre> <h5>返回参数说明</h5> <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;">status</td> <td style="text-align: left;">int</td> <td>pending 交易处理中 succeeded 交易成功 failed 交易失败</td> </tr> </tbody> </table>

页面列表

ITEM_HTML