3.4 交易退款
<h2>描述</h2>
<p>当交易发生之后一段时间内,由于买家或者卖家的原因需要退款时,卖家可以通过退款接口将支付款退还给买家,PayCloud平台将在收到退款请求并且验证成功之后,按照退款规则将支付款按原路退到买家帐号上。</p>
<blockquote>
<p>注意:
1、交易允许退款的期限请咨询商务联系人;
2、退款支持单笔交易分多次退款,多次退款需要提交原支付订单的商户订单号和设置不同的退款单号。申请退款总金额不能超过订单金额。 一笔退款失败后重新提交,请不要更换退款单号,请使用原商户退款单号。
3、每个支付订单的部分退款次数不能超过10次</p>
</blockquote>
<h2>请求参数</h2>
<h4>公共参数</h4>
<p>参见【<a href="https://www.showdoc.com.cn/1724151917532295/8175841214113582">请求报文 - 公共参数</a>】</p>
<h4>业务参数</h4>
<table>
<thead>
<tr>
<th><strong>参数KEY</strong></th>
<th><strong>参数名称</strong></th>
<th><strong>类型</strong></th>
<th><strong>必要性</strong></th>
<th><strong>描述</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>method</td>
<td>请求方法</td>
<td>TEXT(128)</td>
<td>M</td>
<td>接口名称,此接口固定值为:paycloud.pay.orderrefund</td>
</tr>
<tr>
<td>merchant_no</td>
<td>商户号</td>
<td>TEXT(32)</td>
<td>M</td>
<td>商户号,在PayCloud平台入驻后分配的商户号</td>
</tr>
<tr>
<td>out_order_no</td>
<td>商户支付单号</td>
<td>TEXT(32)</td>
<td>C</td>
<td>商户系统内部订单号,只允许数字或英文字母、下划线</td>
</tr>
<tr>
<td>orig_trans_no</td>
<td>原支付交易号</td>
<td>TEXT(32)</td>
<td>C</td>
<td>PayCloud平台交易号,商户订单号和交易号二选一必传</td>
</tr>
<tr>
<td>out_refund_no</td>
<td>商户退款单号</td>
<td>TEXT(32)</td>
<td>M</td>
<td>商户系统内部的退款单号,商户系统内部唯一,只能是数字、大小写字母、下划线 ,同一退款单号多次请求只退一笔,同一app_id下商户退款单号不能重复</td>
</tr>
<tr>
<td>refund_amount</td>
<td>退款金额</td>
<td>AMOUNT</td>
<td>M</td>
<td>本次申请退款金额</td>
</tr>
<tr>
<td>refund_desc</td>
<td>退款原因</td>
<td>TEXT(64)</td>
<td>O</td>
<td>例:商品已售完</td>
</tr>
<tr>
<td>extension_parameters</td>
<td>扩展参数</td>
<td>JSONObject</td>
<td>O</td>
<td>扩展输入参数,后续定义增加的参数存储于此JSON可变结构中</td>
</tr>
</tbody>
</table>
<h2></h2>
<h2>响应参数</h2>
<h4>公共参数</h4>
<p>参见【<a href="https://www.showdoc.com.cn/1724151917532295/8175841214113582">响应报文 - 公共参数</a>】</p>
<h4>业务参数</h4>
<p>当 code=0 时,data[0] 返回如下参数:</p>
<table>
<thead>
<tr>
<th><strong>参数KEY</strong></th>
<th><strong>参数名称</strong></th>
<th><strong>类型</strong></th>
<th><strong>必要性</strong></th>
<th><strong>描述</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>orig_trans_no</td>
<td>原交易号</td>
<td>TEXT(32)</td>
<td>M</td>
<td>原消费/预授权交易号</td>
</tr>
<tr>
<td>refund_trans_no</td>
<td>退款交易号</td>
<td>TEXT(32)</td>
<td>M</td>
<td>PayCloud平台退款单号</td>
</tr>
<tr>
<td>out_order_no</td>
<td>商户订单号</td>
<td>TEXT(32)</td>
<td>M</td>
<td>订单支付时传入的商户订单号</td>
</tr>
<tr>
<td>out_refund_no</td>
<td>商户退款单号</td>
<td>TEXT(32)</td>
<td>M</td>
<td>商户退款请求流水号,标识一次退款请求,支付订单号和退款订单号不能重复</td>
</tr>
<tr>
<td>trans_status</td>
<td>交易状态</td>
<td>TEXT</td>
<td>M</td>
<td>交易状态:PREORDER - 交易预下单PROCESSING-买家支付中或系统退款中CLOSE-交易关闭,包括主动取消,超时未支付关闭,交易失败关闭SUCCESS-交易完成</td>
<td>当 trans_status交易状态为:SUCCESS-交易完成 时,data[0] 返回如下参数:</td>
</tr>
</tbody>
</table>
<table>
<thead>
<tr>
<th><strong>参数KEY</strong></th>
<th><strong>参数名称</strong></th>
<th><strong>类型</strong></th>
<th><strong>必要性</strong></th>
<th><strong>描述</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>refund_trans_end_time</td>
<td>退款完成时间</td>
<td>DATE</td>
<td>M</td>
<td></td>
</tr>
<tr>
<td>pay_channel_trans_no</td>
<td>退款支付通道交易号</td>
<td>TEXT(32)</td>
<td>O</td>
<td></td>
</tr>
<tr>
<td>pay_platform_trans_no</td>
<td>退款支付平台交易号</td>
<td>TEXT(32)</td>
<td>O</td>
<td></td>
</tr>
</tbody>
</table>