6.4 扫码退款申请
<p>[TOC]</p>
<h5>简要描述</h5>
<ul>
<li>该接口用于扫码交易进行退款操作,针对原订单交易进行反向退款操作;注意:退款操作不会退手续费!</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>http://pay.test.891tech.com/website/agent/isv/refundAppPayComfiy.action</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>POST 【application/json】</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;">bizType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>请求接口名,固定:refundAppPayComfiy</td>
</tr>
<tr>
<td style="text-align: left;">agentNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>代理商编号</td>
</tr>
<tr>
<td style="text-align: left;">merchantNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>子商户编号</td>
</tr>
<tr>
<td style="text-align: left;">orderNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>本次请求单号</td>
</tr>
<tr>
<td style="text-align: left;">orgOrderNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>原交易订单号</td>
</tr>
<tr>
<td style="text-align: left;">amount</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>退款金额,单位元</td>
</tr>
<tr>
<td style="text-align: left;">orderIP</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>退款请求IP</td>
</tr>
<tr>
<td style="text-align: left;">callbackUrl</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>退款回调地址</td>
</tr>
<tr>
<td style="text-align: left;">reMark</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>退款备注</td>
</tr>
<tr>
<td style="text-align: left;">splitBillJson</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>退款的分账规则,如果交易中有,建议退款务必上传!系统针对原有分账参数并且金额不等于原金额的退款申请进行必须校验,其余情况不校验</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<pre><code>{
&quot;bizType&quot;: &quot;refundAppPayComfiy&quot;,
&quot;orderNo&quot;: &quot;20220820125157178&quot;,
&quot;agentNo&quot;: &quot;AG00000000000012&quot;,
&quot;data&quot;: &quot;LY7D37jvzG4BWzRAPWzDJMbjJggKqozC7XEeikRoqSwJKrcz5TaIkMngQOUKJMS7BjJS3Ur5e3aAAdHrNNp+xT+Gm9CNCLJ3To6VEYBKpT/dLKCjUfyzdJLV6X5lX5QDxrD9qovm+PoeQ2wXWEXfVIEk8pFjWC1i4UIbM6oDabUkxS0x1nl7SlRgjgHga48bI/BK8LTkTRLV+VP9W9eGG9Dd68YKFsK4Xd7M98bUimJa+JMYpwA2XQ==&quot;,
&quot;signature&quot;: &quot;XegRYrWZoff04gdloroi6vvQg+py4CBui4YMD7R+WxoPeFEMLmAYLny+aUokXQr8xbSaK0jncuXqVg2EPiq6XDMXjhq1bhldiaF7ItTgwrQXJms1KMR2N5c8pc/8sjIHvsjHxHDMtXazNfa7/i7wvJrzspsiGSDdRjopTA5iu5lt32NBMtoayvBEQHMjvxwLit5RMRr1Gmiy/926aZBayxR/tJwjq9mQaFjsdlBKilKUOtOenH8L8O0u/t5ARu38eleTNfZ1zNBAbgOqpc3zG652HW4rNg9KRnCbbKsjEJ1uL9mk3/rDPYfUhkPolHb69lI0t3HLLnn4a7NMmM6l7w==&quot;,
&quot;retCode&quot;: &quot;C0000&quot;,
&quot;retMsg&quot;: &quot;成功&quot;
}</code></pre>
<h5>返回解密参数</h5>
<pre><code>{
&quot;amount&quot;: 0.01,
&quot;appPayType&quot;: &quot;WXPAY&quot;,
&quot;merchantNo&quot;: &quot;M00000000000183&quot;,
&quot;orderNo&quot;: &quot;20220820125157178&quot;,
&quot;payType&quot;: &quot;APPLET&quot;,
&quot;refundRequestStatus&quot;: &quot;INIT&quot;,
&quot;serialNumber&quot;: &quot;RF1660971367852&quot;,
&quot;channelRetCode&quot;:&quot;&quot;,
&quot;channelRetMsg&quot;:&quot;&quot;,
&quot;completeDate&quot;:&quot;&quot;,
}</code></pre>
<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;">merchantNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>商户号</td>
</tr>
<tr>
<td style="text-align: left;">orderNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>退款请求单号</td>
</tr>
<tr>
<td style="text-align: left;">amount</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>退款金额</td>
</tr>
<tr>
<td style="text-align: left;">appPayType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>客户端类型</td>
</tr>
<tr>
<td style="text-align: left;">payType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>交易类型</td>
</tr>
<tr>
<td style="text-align: left;">refundRequestStatus</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>退款订单的状态,请查询字段说明,以状态为准;</td>
</tr>
<tr>
<td style="text-align: left;">serialNumber</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>我方系统唯一流水号</td>
</tr>
<tr>
<td style="text-align: left;">channelRetCode</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>渠道返回码</td>
</tr>
<tr>
<td style="text-align: left;">channelRetMsg</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>渠道返回信息</td>
</tr>
<tr>
<td style="text-align: left;">completeDate</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>完成时间</td>
</tr>
<tr>
<td style="text-align: left;">splitBillJson</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>分账参数</td>
</tr>
</tbody>
</table>
<ul>
<li>分账参数例子
<pre><code>[{&quot;splitBillMerchantNo&quot;:&quot;M00000000000304XXXX&quot;,&quot;splitBillAmount&quot;:0.02}]</code></pre>
<p>其中splitBillMerchantNo为进件返回的商户号,splitBillAmount为需要分账的金额,目前分账有比例限制,各个商户情况不一样,具体需求联系我司;</p></li>
</ul>
<h5>备注</h5>
<p>-如果下单返回【C9999】【请求过多,系统繁忙!】,请为确保业务安全,请调用一次查询接口。</p>