891支付项目

891支付项目


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>{ &amp;quot;bizType&amp;quot;: &amp;quot;refundAppPayComfiy&amp;quot;, &amp;quot;orderNo&amp;quot;: &amp;quot;20220820125157178&amp;quot;, &amp;quot;agentNo&amp;quot;: &amp;quot;AG00000000000012&amp;quot;, &amp;quot;data&amp;quot;: &amp;quot;LY7D37jvzG4BWzRAPWzDJMbjJggKqozC7XEeikRoqSwJKrcz5TaIkMngQOUKJMS7BjJS3Ur5e3aAAdHrNNp+xT+Gm9CNCLJ3To6VEYBKpT/dLKCjUfyzdJLV6X5lX5QDxrD9qovm+PoeQ2wXWEXfVIEk8pFjWC1i4UIbM6oDabUkxS0x1nl7SlRgjgHga48bI/BK8LTkTRLV+VP9W9eGG9Dd68YKFsK4Xd7M98bUimJa+JMYpwA2XQ==&amp;quot;, &amp;quot;signature&amp;quot;: &amp;quot;XegRYrWZoff04gdloroi6vvQg+py4CBui4YMD7R+WxoPeFEMLmAYLny+aUokXQr8xbSaK0jncuXqVg2EPiq6XDMXjhq1bhldiaF7ItTgwrQXJms1KMR2N5c8pc/8sjIHvsjHxHDMtXazNfa7/i7wvJrzspsiGSDdRjopTA5iu5lt32NBMtoayvBEQHMjvxwLit5RMRr1Gmiy/926aZBayxR/tJwjq9mQaFjsdlBKilKUOtOenH8L8O0u/t5ARu38eleTNfZ1zNBAbgOqpc3zG652HW4rNg9KRnCbbKsjEJ1uL9mk3/rDPYfUhkPolHb69lI0t3HLLnn4a7NMmM6l7w==&amp;quot;, &amp;quot;retCode&amp;quot;: &amp;quot;C0000&amp;quot;, &amp;quot;retMsg&amp;quot;: &amp;quot;成功&amp;quot; }</code></pre> <h5>返回解密参数</h5> <pre><code>{ &amp;quot;amount&amp;quot;: 0.01, &amp;quot;appPayType&amp;quot;: &amp;quot;WXPAY&amp;quot;, &amp;quot;merchantNo&amp;quot;: &amp;quot;M00000000000183&amp;quot;, &amp;quot;orderNo&amp;quot;: &amp;quot;20220820125157178&amp;quot;, &amp;quot;payType&amp;quot;: &amp;quot;APPLET&amp;quot;, &amp;quot;refundRequestStatus&amp;quot;: &amp;quot;INIT&amp;quot;, &amp;quot;serialNumber&amp;quot;: &amp;quot;RF1660971367852&amp;quot;, &amp;quot;channelRetCode&amp;quot;:&amp;quot;&amp;quot;, &amp;quot;channelRetMsg&amp;quot;:&amp;quot;&amp;quot;, &amp;quot;completeDate&amp;quot;:&amp;quot;&amp;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>[{&amp;quot;splitBillMerchantNo&amp;quot;:&amp;quot;M00000000000304XXXX&amp;quot;,&amp;quot;splitBillAmount&amp;quot;:0.02}]</code></pre> <p>其中splitBillMerchantNo为进件返回的商户号,splitBillAmount为需要分账的金额,目前分账有比例限制,各个商户情况不一样,具体需求联系我司;</p></li> </ul> <h5>备注</h5> <p>-如果下单返回【C9999】【请求过多,系统繁忙!】,请为确保业务安全,请调用一次查询接口。</p>

页面列表

ITEM_HTML