退款
<h5>退款接口</h5>
<ul>
<li><span style="color:#F00"> 订单状态为“SUCCESS”时才能发起退款。</span></li>
<li><span style="color:#F00"> 退款支持单笔交易分多次退款，多次退款需要提交原支付订单的商户订单号和不同的退款单号，总退款金额不能超过用户实际支付金额。</span></li>
<li><span style="color:#F00"> 申请退款接口的响应参数errCode仅代表业务的受理情况，具体退款是否成功，需要通过申请退款或查询退款接口返回的refundStatus获取退款结果。</li>
<li>当响应参数errCode=0000时,说明微保已受理该笔退款,此时需要根据refundStatus来判断退款状态；</span></li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>/api/vborder/order/standard/refund</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;">refOrderNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(64)</td>
<td>下单的商户订单号 <br><span style="color:#F00">示例：20220907000001</td>
</tr>
<tr>
<td style="text-align: left;">orderNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(64)</td>
<td>退款订单号 商户系统内部生成的订单号，需要保持在同一个商户下唯一 <br><span style="color:#F00">示例：202209070002</td>
</tr>
<tr>
<td style="text-align: left;">refundAmount</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Long(11)</td>
<td>退款金额,以分为单位 <br><span style="color:#F00">示例：1</td>
</tr>
<tr>
<td style="text-align: left;">refundAccountType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(11)</td>
<td>退款账户类型 <br> REFUND：退款账户 <br> RECEIPT 收单账户<br><span style="color:#F00">示例： REFUND</td>
</tr>
<tr>
<td style="text-align: left;">notifyUrl</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(256)</td>
<td>退款结果通知地址 <br><span style="color:#F00">示例： <a href="https://notify.com/xxx">https://notify.com/xxx</a></td>
</tr>
<tr>
<td style="text-align: left;">ext1</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(512)</td>
<td>附加数据,原样返回</td>
</tr>
<tr>
<td style="text-align: left;">ext2</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(512)</td>
<td>附加数据,原样返回</td>
</tr>
</tbody>
</table>
<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;">customerNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(32)</td>
<td>商户号 <br><span style="color:#F00">示例：202112090603</td>
</tr>
<tr>
<td style="text-align: left;">refOrderNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(64)</td>
<td>下单的商户订单号 <br><span style="color:#F00">示例： 202209070001</td>
</tr>
<tr>
<td style="text-align: left;">orderNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(64)</td>
<td>退款订单号 <br><span style="color:#F00">示例： 202209070002</td>
</tr>
<tr>
<td style="text-align: left;">refundAmount</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Long(11)</td>
<td>退款金额,以分为单位 <br><span style="color:#F00">示例： 1</td>
</tr>
<tr>
<td style="text-align: left;">refundTime</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(18)</td>
<td>退款时间格式：yyyy-MM-dd HH:mm:ss <br><span style="color:#F00">示例： 2022-09-07 10:01:05</td>
</tr>
<tr>
<td style="text-align: left;">refundStatus</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(11)</td>
<td>退款状态 <br>PROCESSING：退款处理中 <br>SUCCESS：退款成功 <br>FAIL：退款失败 <br><span style="color:#F00">示例：PROCESSING</td>
</tr>
<tr>
<td style="text-align: left;">ext1</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(512)</td>
<td>附加数据,原样返回</td>
</tr>
<tr>
<td style="text-align: left;">ext2</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(512)</td>
<td>附加数据,原样返回</td>
</tr>
<tr>
<td style="text-align: left;">errCode</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(32)</td>
<td>错误编码 errCode不等于0000时，其他参数可能为空 <br><span style="color:#F00">示例：0000</td>
</tr>
<tr>
<td style="text-align: left;">errMessage</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(256)</td>
<td>错误描述 <br><span style="color:#F00">示例：成功</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<pre><code>{
"code":"200",
"success":true,
"data":"{\"customerNo\":\"202112090603\",\"reqmsg\":\"ZVnP6b4WK5Ja7UticBJMv/1FJ/sG/CKeWcoCiFoBYAFmoUP48JDEYbLpGSA3Aou8mQ2kZwe/CmWBT030R69QiheZpscDkzM+Qt6NVyEirDrHxQvgH4u1OnWd+VDeQKv9qXiLBwlxp2bD+bLOWhr2Fv2uSRdH5ZVErZVaax6+BVlfJ6rr+ZRtZFfS9gz+1e1XJGuD2zukvOxuoOZohAQHgA7L10pnRT5Hof9F/iexqS0fkyOe08hWc1eM7+TnwhK72aTglh/ThnIrT81dyG4+FKJBDPiD5z3UjsEclny/vkWFjg7WpzCdIdPwf7uetxuB+DF9mCiHQ1MidQzdzJ+nVoadU/W93UOFhde7V5WIfqkXRH/eX/KlPiHfuoaQvPHb0+aKO/hUpljEpXCI1zys/RANPRmCCGP/PaHWTiGl+69e039iATQEsxV2tdGmrtYokWTrQuJ/mvPOwn1xW+aYYRB+9MCXWo1/NC66BNBrgkr63GvgCuYWVJqLyCkRt6rbdbT4invV0mfcsmnlNDOLajMVse1mTrqEWkFS4tjd0WmD5oRHMSN49Y6McpTysfXueU7IfEn9aQSPuHCL4njnxwI1eD97rWoYkHk1brL86J6Y9yaglsbJZq3gcuA9Hic++0kCskF1FN7x98v5NvRaVpmS/+u7SErTmYjEKpnSebU=\"}",
"msg":"操作成功"
}
reqmsg明文：
{
"orderNo": "20220907000001",
"refOrderNo": "202209070002",
"customerNo": "202112090603",
"refundAmount": 1,
"refundStatus": "PROCESSING",
"refundTime": "2022-09-07 10:01:05",
"errCode": "0000",
"errMessage": "成功"
}</code></pre>
<h5>备注</h5>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>