待退款订单创建
<p><strong>接口描述：</strong> </p>
<ul>
<li>待退款订单创建接口，用于POS内置的APP发起有订单退款</li>
<li>释义：</li>
<li>1）用户调用此接口创建待退款订单，传原支付订单进行绑定</li>
<li>2）通过POS内置的APP调用待退款订单查询接口，对待退款订单发起退款</li>
<li>3）支付完成后订单支付类型、支付方式同步为用户实际付款信息</li>
</ul>
<p><strong>接口URL：</strong>
测试 <code>https://test.gdyfsk.com/yfpay/v3/trade/createRefundPay</code>
正式 <code>https://open.gdyfsk.com/yfpay/v3/trade/createRefundPay</code></p>
<p><strong>请求方式：</strong></p>
<ul>
<li>POST </li>
</ul>
<p><strong>请求头部：</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">标签</th>
<th style="text-align: left;">必填</th>
<th>内容</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">Content-Type</td>
<td style="text-align: left;">是</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: 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;">inst_no</td>
<td style="text-align: left;">string(8)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">机构号，系统分配</td>
<td>900075</td>
</tr>
<tr>
<td style="text-align: left;">mch_no</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">商户号</td>
<td>Y52211090004</td>
</tr>
<tr>
<td style="text-align: left;">refund_trace_no</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">请求流水号（在商户系统内唯一）</td>
<td>51c7d68424e5492199cf7f4734a2b977</td>
</tr>
<tr>
<td style="text-align: left;">refund_fee</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">退款金额，单位：分</td>
<td>100</td>
</tr>
<tr>
<td style="text-align: left;">out_trade_no</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">原支付订单</td>
<td>51c7d68424e5492199cf7f4734a2b977</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">签名</td>
<td>51c7d68424e5492199cf7f4734a2b977</td>
</tr>
</tbody>
</table>
<p><strong>请求示例：</strong></p>
<pre><code class="language-json">{
&quot;pay_trace_no&quot;: &quot;57c8666e21274ebc81c83774e3754496&quot;,
&quot;inst_no&quot;: &quot;xxx&quot;,
&quot;terminal_no&quot;: &quot;xxx&quot;,
&quot;total_amount&quot;: &quot;1&quot;,
&quot;sign&quot;: &quot;3ac14bc7a0bce75a2c2aaad45938a647&quot;,
&quot;mch_no&quot;: &quot;xxx&quot;,
&quot;notify_url&quot;: &quot;www.baidu.com&quot;,
&quot;order_body&quot;: &quot;夏季校服&quot;,
&quot;shop_no&quot;: &quot;&quot;
}</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>
<th>参数示例</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">return_code</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">是</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: left;">string(128)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">返回消息提示 关单成功，关单失败等</td>
</tr>
<tr>
<td style="text-align: left;">result_code</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">只有在return_code为SUCCESS时有返回，PAY_SUCEESS为创建订单成功</td>
</tr>
<tr>
<td style="text-align: left;">pay_type</td>
<td style="text-align: left;">int(10)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">300.支付宝，400.微信，600.云闪付</td>
</tr>
<tr>
<td style="text-align: left;">mch_name</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">商户名称</td>
<td>张三个体户</td>
</tr>
<tr>
<td style="text-align: left;">shop_name</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">门店名称</td>
<td>金沙洲店</td>
</tr>
<tr>
<td style="text-align: left;">mch_no</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">商户号</td>
<td>Y52211090004</td>
</tr>
<tr>
<td style="text-align: left;">shop_no</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">门店号</td>
<td>S000001</td>
</tr>
<tr>
<td style="text-align: left;">refund_trace_no</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">退款请求流水号</td>
<td>51c7d68424e5492199cf7f4734a2b977</td>
</tr>
<tr>
<td style="text-align: left;">refund_fee</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">退款金额，单位：分</td>
<td>100</td>
</tr>
<tr>
<td style="text-align: left;">refund_no</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">乐收赢订单号</td>
<td>2018116165053</td>
</tr>
<tr>
<td style="text-align: left;">attach</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">自定义参数，原样返回</td>
<td>1234</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">签名字符串</td>
<td>51c7d68424e5492199cf7f4734a2b977</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;success&quot;,
&quot;mch_name&quot;: &quot;xxx&quot;,
&quot;shop_name&quot;: &quot;&quot;,
&quot;mch_no&quot;: &quot;xxx&quot;,
&quot;shop_no&quot;: &quot;&quot;,
&quot;pay_trace_no&quot;: &quot;57c8666e21274ebc81c83774e3754496&quot;,
&quot;total_amount&quot;: &quot;1&quot;,
&quot;out_trade_no&quot;: &quot;200002394PAY250107163728T0xx&quot;,
&quot;attach&quot;: null,
&quot;terminal_no&quot;: &quot;xxx&quot;,
&quot;sign&quot;: &quot;305a4e36981da8266fb2abc0482c5793&quot;
}</code></pre>