退款查询
<p><strong>接口描述：</strong></p>
<ul>
<li>申请退款后如需确认退款状态，可调用此接口进行查询</li>
<li>此接口仅支持退款订单的查询，支付订单的查询请调用交易查询接口</li>
</ul>
<p><strong>接口URL：</strong>
测试 <code>https://test.gdyfsk.com/yfpay/v3/queryrefund</code>
正式 <code>https://open.gdyfsk.com/yfpay/v3/queryrefund</code></p>
<p><strong>请求方式：</strong></p>
<ul>
<li>POST</li>
</ul>
<p><strong>请求头部：</strong></p>
<table>
<thead>
<tr>
<th>标签</th>
<th>必填</th>
<th>内容</th>
</tr>
</thead>
<tbody>
<tr>
<td>Content-Type</td>
<td>是</td>
<td>application/json</td>
</tr>
</tbody>
</table>
<p><strong>请求参数：</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: center;">类型</th>
<th style="text-align: center;">必填</th>
<th style="text-align: left;">说明</th>
<th>参数示例</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">inst_no</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">机构号 ，系统分配</td>
<td>900075</td>
</tr>
<tr>
<td style="text-align: left;">mch_no</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">商户号</td>
<td>Y52211090004</td>
</tr>
<tr>
<td style="text-align: left;">query_trace_no</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">查询请求流水号</td>
<td>df77d158-c882-468a-99b0-980c33427f13</td>
</tr>
<tr>
<td style="text-align: left;">acct_split_bunch</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">否</td>
<td style="text-align: left;">开启多方分账，并且部分退款可用</td>
<td>字符串 json格式</td>
</tr>
<tr>
<td style="text-align: left;">--acct_infos</td>
<td style="text-align: center;">jsonArray</td>
<td style="text-align: center;">否</td>
<td style="text-align: left;">部分退款数组</td>
<td>jsonArray</td>
</tr>
<tr>
<td style="text-align: left;">----div_amt</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">否</td>
<td style="text-align: left;">分账金额</td>
<td>单位元，需保留小数点后两位，示例值：1.00，最低传入0.01</td>
</tr>
<tr>
<td style="text-align: left;">----huifu_id</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">否</td>
<td style="text-align: left;">分账接收方ID</td>
<td>示例值：6666000108854952</td>
</tr>
<tr>
<td style="text-align: left;">refund_no</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">退款订单号</td>
<td style="text-align: left;">200001165F40191113104923T0002</td>
</tr>
<tr>
<td style="text-align: left;">refund_trace_no</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">退款时的请求流水号</td>
<td style="text-align: left;">b79ffba7-4560-4006-90a2-6a09a206285c</td>
</tr>
<tr>
<td style="text-align: left;">refund_time</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">退款时的请求时间</td>
<td style="text-align: left;">20191113104923</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">签名字符串</td>
<td>932d533354a9aa456de9926b9e046db8</td>
</tr>
</tbody>
</table>
<ul>
<li>注：<code>refund_no</code>与<code>refund_trace_no</code>二选其一必填</li>
</ul>
<p><strong>请求示例：</strong></p>
<pre><code class="language-json">{
&quot;inst_no&quot;: &quot;900075&quot;,
&quot;mch_no&quot;: &quot;Y52211090004&quot;,
&quot;query_trace_no&quot;: &quot;df77d158-c882-468a-99b0-980c33427f13&quot;,
&quot;refund_no&quot;: &quot;200001165F40191113104923T0002&quot;,
&quot;sign&quot;: &quot;932d533354a9aa456de9926b9e046db8&quot;
}</code></pre>
<p><strong>返回参数：</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: center;">类型</th>
<th style="text-align: center;">必填</th>
<th style="text-align: left;">说明</th>
<th>参数示例</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">return_code</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">响应码：SUCCESS成功，FAIL失败，响应码仅代表通信状态或参数合规</td>
<td>SUCCESS</td>
</tr>
<tr>
<td style="text-align: left;">return_msg</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">返回信息提示，“退款成功”，“退款申请中”，“参数不合法” 等</td>
<td>退款成功</td>
</tr>
</tbody>
</table>
<ul>
<li>以下参数在<code>return_code</code>为<code>SUCCESS</code>时返回</li>
</ul>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: center;">类型</th>
<th style="text-align: center;">必填</th>
<th style="text-align: left;">说明</th>
<th>参数示例</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">result_code</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">业务结果：PAY_SUCCESS退款成功 ，PAY_IN_PROCESS退款申请中 ，PAY_FAIL退款申请失败</td>
<td>PAY_SUCCESS</td>
</tr>
<tr>
<td style="text-align: left;">pay_type</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">支付类型：300支付宝，400微信，900.龙支付</td>
<td>400</td>
</tr>
<tr>
<td style="text-align: left;">mch_name</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">商户名称</td>
<td>TEST聪明付</td>
</tr>
<tr>
<td style="text-align: left;">mch_no</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">商户号</td>
<td>Y52211090004</td>
</tr>
<tr>
<td style="text-align: left;">shop_name</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;"></td>
<td style="text-align: left;">门店名称</td>
<td>1号店</td>
</tr>
<tr>
<td style="text-align: left;">shop_no</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;"></td>
<td style="text-align: left;">门店号</td>
<td>86000033007</td>
</tr>
<tr>
<td style="text-align: left;">query_trace_no</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">查询请求流水号</td>
<td>df77d158-c882-468a-99b0-980c33427f13</td>
</tr>
<tr>
<td style="text-align: left;">refund_trace_no</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">退款时的请求流水号</td>
<td>b79ffba7-4560-4006-90a2-6a09a206285c</td>
</tr>
<tr>
<td style="text-align: left;">refund_time</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">退款时的请求时间</td>
<td>20191113104923</td>
</tr>
<tr>
<td style="text-align: left;">total_amount</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">订单支付总金额，单位：分</td>
<td>100</td>
</tr>
<tr>
<td style="text-align: left;">refund_amount</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">申请退款金额，单位：分</td>
<td>100</td>
</tr>
<tr>
<td style="text-align: left;">refund_settle</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;"></td>
<td style="text-align: left;">实退金额，单位：分，实退金额≤申请退款金额</td>
<td>100</td>
</tr>
<tr>
<td style="text-align: left;">trade_no</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">原交易订单号</td>
<td>200001165F41191113104149T0001</td>
</tr>
<tr>
<td style="text-align: left;">refund_no</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">退款订单号</td>
<td>200001165F40191113104923T0002</td>
</tr>
<tr>
<td style="text-align: left;">td_trade_no</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;"></td>
<td style="text-align: left;">通道退款订单号</td>
</tr>
<tr>
<td style="text-align: left;">qd_trade_no</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;"></td>
<td style="text-align: left;">渠道退款订单号</td>
<td>20191113101416980262</td>
</tr>
<tr>
<td style="text-align: left;">user_id</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;"></td>
<td style="text-align: left;">付款方用户id</td>
<td>olKmOs_fIK95vHwIG2pITMN7OYgY</td>
</tr>
<tr>
<td style="text-align: left;">attach</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;"></td>
<td style="text-align: left;">扩展字段原样返回</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: center;">string</td>
<td style="text-align: center;">是</td>
<td style="text-align: left;">签名字符串</td>
<td>d43d0814e54f586b50b2b7c8ca34f9c4</td>
</tr>
</tbody>
</table>
<p><strong>返回示例：</strong></p>
<pre><code class="language-json">{
&quot;return_code&quot;: &quot;SUCCESS&quot;,
&quot;return_msg&quot;: &quot;退款成功&quot;,
&quot;result_code&quot;: &quot;PAY_SUCCESS&quot;,
&quot;pay_type&quot;: &quot;400&quot;,
&quot;mch_name&quot;: &quot;TEST聪明付&quot;,
&quot;shop_name&quot;: &quot;&quot;,
&quot;mch_no&quot;: &quot;Y52211090004&quot;,
&quot;shop_no&quot;: &quot;&quot;,
&quot;query_trace_no&quot;: &quot;df77d158-c882-468a-99b0-980c33427f13&quot;,
&quot;refund_trace_no&quot;: &quot;b79ffba7-4560-4006-90a2-6a09a206285c&quot;,
&quot;refund_time&quot;: &quot;20191113104923&quot;,
&quot;total_amount&quot;: &quot;1&quot;,
&quot;refund_amount&quot;: &quot;1&quot;,
&quot;refund_settle&quot;: &quot;1&quot;,
&quot;trade_no&quot;: &quot;200001165F41191113104149T0001&quot;,
&quot;refund_no&quot;: &quot;200001165F40191113104923T0002&quot;,
&quot;td_trade_no&quot;: null,
&quot;qd_trade_no&quot;: &quot;&quot;,
&quot;user_id&quot;: null,
&quot;attach&quot;: &quot;附加字段&quot;,
&quot;sign&quot;: &quot;d43d0814e54f586b50b2b7c8ca34f9c4&quot;
}</code></pre>