商户订单退款
<p><strong>简要描述:</strong></p>
<ul>
<li>代收订单退款接口</li>
<li>手动退款模式</li>
<li>订单回调接口跟【商户代付回调接口】是同一个</li>
</ul>
<p><strong>请求URL:</strong></p>
<ul>
<li>mchRefund</li>
</ul>
<p><strong>接口请求参数:</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">beneName</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string(40)</td>
<td style="text-align: left;">收款方姓名,仅允许英文和空格</td>
</tr>
<tr>
<td style="text-align: left;">beneAccNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string(50)</td>
<td style="text-align: left;">收款方银行账号(非银行卡卡号。银行卡除了本身卡片上的卡号,在银行处还有一个对应账户号,这里使用的是银行的账户号),6-20位数字</td>
</tr>
<tr>
<td style="text-align: left;">bankName</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string(50)</td>
<td style="text-align: left;">收款方银行名称,仅允许英文和空格</td>
</tr>
<tr>
<td style="text-align: left;">beneIFSC</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string(50)</td>
<td style="text-align: left;">收款方银行账号所在银行IFSC号,目前IFSC格式位11位长度的英文+数字</td>
</tr>
<tr>
<td style="text-align: left;">beneMobile</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">number(10)</td>
<td style="text-align: left;">收款方手机号,10位数字</td>
</tr>
<tr>
<td style="text-align: left;">txnId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string(50)</td>
<td style="text-align: left;">退款订单ID, 商户端生成(仅允许字母及数字,不区分大小写)</td>
</tr>
<tr>
<td style="text-align: left;">mpOrderId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string(50)</td>
<td style="text-align: left;">原始商户订单ID, 需要退款的Mpurse订单ID</td>
</tr>
<tr>
<td style="text-align: left;">amount</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">退款金额。需要跟原始商户订单金额保持一致</td>
</tr>
<tr>
<td style="text-align: left;">remark</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">alphanumbric(100)</td>
<td style="text-align: left;">备注</td>
</tr>
</tbody>
</table>
<p><strong>请求示例:</strong></p>
<pre><code> {
"beneName": "Bodhi",
"beneAccNo": "316278361248",
"bankName": "State Bank of India",
"beneIFSC": "SBOI14431",
"beneMobile": "8884561110",
"txnId": "10085231",
"mpOrderId": "773289555",
"amount": "2000",
"remark": "test"
}
</code></pre>
<p><strong>响应参数:</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">txnId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">商户订单id</td>
</tr>
<tr>
<td style="text-align: left;">status</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">订单状态: PENDING(处理中), TRANSACTION_SUCCESS(成功). TRANSACTION_FAILURE(失败)</td>
</tr>
<tr>
<td style="text-align: left;">mpRefId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">mpurse端关联的订单id</td>
</tr>
<tr>
<td style="text-align: left;">amount</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">金额</td>
</tr>
<tr>
<td style="text-align: left;">beneAccNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">收款银行账户</td>
</tr>
<tr>
<td style="text-align: left;">beneIFSC</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">收款银行IFSC</td>
</tr>
<tr>
<td style="text-align: left;">partnerId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">商户partnerId</td>
</tr>
<tr>
<td style="text-align: left;">txnCompletionDate</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">订单完成时间,格式 yyyyMMddHHmmss</td>
</tr>
<tr>
<td style="text-align: left;">errorMsg</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">订单失败原因</td>
</tr>
</tbody>
</table>
<p><strong>返回示例</strong></p>
<pre><code> {
"status": "0000",
"message": "success",
"retBizParams": {
"txnId": "10085231",
"status": "TRANSACTION_SUCCESS",
"mpRefId": "31789314242",
"amount": "2000",
"beneAccNo": "316278361248",
"beneIFSC": "SBOI1443134",
"partnerId": "MCT_PARTNER_1025",
"txnCompletionDate": "20200305134512",
"errorMsg": "success"
}
}
</code></pre>