支付退款
<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 形式,详见 分账对象信息列表 ;若原交易对象未分账,则创建退款对象时,该字段不传;若原交易对象分账,则退款分账对象必须在原交易参与的分账方范围内,分账对象列表内的总金额必须等于退款金额,每个分账对象的退分账金额必须满足:退分账金额+已退分账金额 <= 原交易分账对象的分账金额。</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>