订单退款查询API
<h5>接口使用描述</h5>
<pre><code>1针对退款订单进行退款状态查询。
2订单subCode返回REFUNDING 需要循环调用退款查询接口
3退款状态 returnRefundType 传1 保证退款中的状态返回</code></pre>
<h5>接口地址</h5>
<pre><code> 接口地址：https://api.liantuofu.com/open/refund/query</code></pre>
<p><br/></p>
<h4>请求参数<img src='<a href="https://www.showdoc.cc/server/api/common/visitfile/sign/bfc24f8d7eb93fae8e66d4ab2b4bc461?showdoc=.jpg'">https://www.showdoc.cc/server/api/common/visitfile/sign/bfc24f8d7eb93fae8e66d4ab2b4bc461?showdoc=.jpg'</a>; align='right' style=' width:300px;height:100 px'/></h4>
<table>
<thead>
<tr>
<th><strong>NO</strong></th>
<th><strong>字段</strong></th>
<th><strong>名称</strong></th>
<th><strong>长度</strong></th>
<th><strong>必填</strong></th>
<th><strong>示例</strong></th>
<th><strong>说明</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>1</td>
<td>appId</td>
<td>合作方标识</td>
<td>string</td>
<td>Y</td>
<td>EW_N2949193174</td>
<td>合作商户编码，用于以后所有接口发起请求时验签使用</td>
</tr>
<tr>
<td>2</td>
<td>sign</td>
<td>签名。具体参见“<a href="https://www.showdoc.cc/web/#/liantuofu?page_id=673453270295568">签名规则</a>”</td>
<td>string</td>
<td>Y</td>
<td>1b70687c8a4c72f50c749baf95a482c0</td>
<td>MD5加密验签值。具体参见“<a href="https://www.showdoc.cc/web/#/liantuofu?page_id=673453270295568">签名规则</a>”</td>
</tr>
<tr>
<td>3</td>
<td>random</td>
<td>随机数</td>
<td>string</td>
<td>Y</td>
<td>123</td>
<td>用来增加加密验签的复杂度，长度不限制，只限制传递数字，不支持中文，字母，特殊符号。</td>
</tr>
<tr>
<td>4</td>
<td>merchantCode</td>
<td>门店编号</td>
<td>string</td>
<td>Y</td>
<td>EW_N9479011740</td>
<td>门店编号，用于后续接口请求参数的使用</td>
</tr>
<tr>
<td>5</td>
<td>refundNo</td>
<td>退款订单号</td>
<td>string(64)</td>
<td>Y</td>
<td>201805031737269202512322520412234</td>
<td>商户系统生成的退款单号，在商户方需全局唯一 每笔退款流水号标示唯一一笔退款交易，所有由商户发起的退款流水号均不能相同。 只能是数字、英文字母、“-”及“_” 同一退款单号多次请求只退一笔。</td>
</tr>
<tr>
<td>6</td>
<td>operatorId（接口客户无需传递）</td>
<td>操作员id</td>
<td>string</td>
<td>N</td>
<td>1234409009</td>
<td>收银员账号登陆时，登陆返回信息中的操作员ID(收银员ID)</td>
</tr>
<tr>
<td>7</td>
<td>returnRefundType</td>
<td>是否返回退款中状态 0否 1是(不传该值则不返回)</td>
<td>string</td>
<td>N</td>
<td>0</td>
<td>0否 1是(不传该值则不返回)</td>
</tr>
</tbody>
</table>
<hr />
<h4>响应参数</h4>
<table>
<thead>
<tr>
<th><strong>NO</strong></th>
<th><strong>字段</strong></th>
<th><strong>名称</strong></th>
<th><strong>长度</strong></th>
<th><strong>必填</strong></th>
<th><strong>示例</strong></th>
<th><strong>说明</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>1</td>
<td>code</td>
<td>结果</td>
<td>string</td>
<td>Y</td>
<td>SUCCESS</td>
<td>查询退款结果 SUCCESS：表示退款成功 FAILED：表示退款失败</td>
</tr>
<tr>
<td>2</td>
<td>msg</td>
<td>结果描述</td>
<td>string</td>
<td>Y</td>
<td>登陆成功</td>
<td>无论是成功或者失败，message都会针对于当前的结果返回响应的结果描述</td>
</tr>
<tr>
<td>3</td>
<td>subCode</td>
<td>错误代码</td>
<td>string</td>
<td>N</td>
<td>REFUNDING</td>
<td>如果code为FAILED，subcode会返回详细的错误code,以便错误信息描述的更加精确 REFUNDING退款中 仍需要调用查询</td>
</tr>
<tr>
<td>4</td>
<td>subMsg</td>
<td>错误描述</td>
<td>string</td>
<td>N</td>
<td>EW_N2320993253</td>
<td>如果code为FAILED，subMsg会返回详细的错误描述,以便错误信息描述的更加精确</td>
</tr>
<tr>
<td>5</td>
<td>sign</td>
<td>签名</td>
<td>string</td>
<td>Y</td>
<td>1b70687c8a4c72f50c749baf95a482c0</td>
<td>请求时传递的sign</td>
</tr>
<tr>
<td>6</td>
<td>random</td>
<td>随机数</td>
<td>string</td>
<td>Y</td>
<td>123</td>
<td>请求时传递的随机数</td>
</tr>
<tr>
<td>7</td>
<td>outTradeNo</td>
<td>商户订单号</td>
<td>string(64)</td>
<td>N</td>
<td>CS100082018050166666</td>
<td>由商户生成的该笔交易的全局唯一ID，商户需确保其唯一性，重新发起一笔支付要使用原订单号，避免重复支付。后续可通过该ID查询对应订单信息。 建议值：公司简称+门店编号+时间戳+序列 支持8-64位数字、英文字母、“-”及“_”，其他字符不支持</td>
</tr>
<tr>
<td>8</td>
<td>refundNo</td>
<td>退款订单号</td>
<td>string(64)</td>
<td>N</td>
<td>201805031737269202512322520412234</td>
<td>商户系统生成的退款单号，在商户方需全局唯一 每笔退款流水号标示唯一一笔退款交易，所有由商户发起的退款流水号均不能相同。 只能是数字、英文字母、“-”及“_” 同一退款单号多次请求只退一笔。</td>
</tr>
<tr>
<td>9</td>
<td>refundAmount</td>
<td>退款金额</td>
<td>string(11)</td>
<td>N</td>
<td>66.66</td>
<td>微信支付退款支持单笔交易分多次退款,申请退款总金额不能超过订单金额, 单位为元，支持两位小数</td>
</tr>
<tr>
<td>10</td>
<td>refundReason</td>
<td>退款的原因说明</td>
<td>string(256)</td>
<td>N</td>
<td>商品已售完</td>
<td>退款的原因说明,若商户传入，会在下发给用户的退款消息中体现退款原因</td>
</tr>
<tr>
<td>11</td>
<td>time</td>
<td>交易完成时间</td>
<td>string</td>
<td>N</td>
<td></td>
<td>交易完成时间,格式为 yyyyMMddHHmmss</td>
</tr>
<tr>
<td>12</td>
<td>refundFee</td>
<td>第三方手续费退款金额</td>
<td>double</td>
<td>N</td>
<td></td>
<td>第三方手续费退款金额</td>
</tr>
</tbody>
</table>
<p><br/><br/></p>
<h5>请求示例:</h5>
<pre><code>refundNo=T2018072511400002&amp;operatorId=10181383&amp;sign=d46d42ce9fa12030ca80236efb6d47c1&amp;appId=SC_I5640724439&amp;random=6666666666666666666&amp;merchantCode=SC_I2528987310</code></pre>
<h5>响应示例（成功）：</h5>
<pre><code class="language-json">{
&quot;code&quot;:&quot;SUCCESS&quot;,
&quot;msg&quot;:&quot;退款成功&quot;,
&quot;random&quot;:&quot;123&quot;,
&quot;sign&quot;:&quot;318120c08a4cb09ee362343e5988e869&quot;,
&quot;outTradeNo&quot;:&quot;2018071914441028168620&quot;,
&quot;refundNo&quot;:&quot;R2018071916271579267306&quot;,
&quot;refundAmount&quot;:-5,
&quot;refundFee&quot;:-0.03,
&quot;time&quot;:&quot;20180719162716&quot;
}</code></pre>
<h5>响应示例（失败）：</h5>
<pre><code class="language-json">{
&quot;code&quot;:&quot;FAILED&quot;,
&quot;msg&quot;:&quot;退款失败&quot;,
&quot;outTradeNo&quot;:&quot;2018010101&quot;,
&quot;refundAmount&quot;:10,
&quot;refundNo&quot;:&quot;R2018010101&quot;,
&quot;subCode&quot;:&quot;REFUND_BALANCE_ERROR&quot;,
&quot;subMsg&quot;:&quot;商家可用退款余额不足&quot;
}</code></pre>
<h5>错误码</h5>
<table>
<thead>
<tr>
<th>错误码</th>
<th>错误描述</th>
<th>建议处理</th>
</tr>
</thead>
<tbody>
<tr>
<td>REFUND_BALANCE_ERROR</td>
<td>商家可用退款余额不足</td>
<td>核实商户当前账户余额</td>
</tr>
<tr>
<td>REFUNDING</td>
<td>退款中</td>
<td>调用退款查询， 继续查询</td>
</tr>
<tr>
<td>SYSTEM_ERROR</td>
<td>系统异常</td>
<td>调用退款查询， 继续查询</td>
</tr>
<tr>
<td>PARAMETER_ERROR</td>
<td>参数错误</td>
<td>传参不对</td>
</tr>
</tbody>
</table>