身边云服务商系统API

API文档示例


订单退款通知

<p>[TOC]</p> <h5>简要描述</h5> <ul> <li>有些交易成功的订单在线下发生退款操作,运营人员会将服务商系统已成功的订单改为失败,失败的订单会同步给业务系统同步更改状态。</li> <li>业务系统返回同步成功→将订单状态改为已退款。</li> <li>业务系统返回失败或者发生错误→订单状态不变。</li> </ul> <h5>业务流程图</h5> <p><img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=485fb32f5c1ea4306c761b9a95f6b149&amp;file=file.png" alt="" /></p> <h5>请求URL</h5> <ul> <li><code>http://channel.serviceshare.com/own/levy/callback/refund/{levyId}</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;">resData</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>回调报文</td> </tr> </tbody> </table> <p>退款回调参数</p> <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;">orderId</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>订单流水号</td> </tr> <tr> <td style="text-align: left;">refundOrderId</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>退款流水号</td> </tr> <tr> <td style="text-align: left;">refundType</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>退款类型</td> </tr> <tr> <td style="text-align: left;">merId</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>商户号</td> </tr> <tr> <td style="text-align: left;">merOrderId</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>商户订单号</td> </tr> <tr> <td style="text-align: left;">merBatchId</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>商户批次号</td> </tr> <tr> <td style="text-align: left;">bankId</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>银行编码</td> </tr> <tr> <td style="text-align: left;">bankMerId</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>银行商户编码</td> </tr> <tr> <td style="text-align: left;">transBatchId</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>交易批次号</td> </tr> <tr> <td style="text-align: left;">transOrderId</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>交易流水号</td> </tr> <tr> <td style="text-align: left;">amt</td> <td style="text-align: left;">是</td> <td style="text-align: left;">long</td> <td>金额</td> </tr> <tr> <td style="text-align: left;">payeeName</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>收款人名称</td> </tr> <tr> <td style="text-align: left;">payeeAcc</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>收款人账号</td> </tr> <tr> <td style="text-align: left;">idCard</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>身份证号</td> </tr> <tr> <td style="text-align: left;">mobile</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>手机号</td> </tr> <tr> <td style="text-align: left;">branchNo</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>联行号</td> </tr> <tr> <td style="text-align: left;">branchName</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>支行名称</td> </tr> <tr> <td style="text-align: left;">separateStatus</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>分账标识</td> </tr> <tr> <td style="text-align: left;">platFee</td> <td style="text-align: left;">是</td> <td style="text-align: left;">long</td> <td>平台手续费</td> </tr> <tr> <td style="text-align: left;">payFeeType</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>费用收取方式</td> </tr> <tr> <td style="text-align: left;">afterTaxAmt</td> <td style="text-align: left;">是</td> <td style="text-align: left;">long</td> <td>税后金额</td> </tr> </tbody> </table> <h5>返回参数</h5> <ul> <li>返回示例</li> </ul> <pre><code> { "success" }</code></pre> <h5>备注</h5> <ul> <li>更多返回错误代码请看首页的错误代码描述</li> </ul>

页面列表

ITEM_HTML