余额支付退款
<p><strong>接口描述：</strong> </p>
<ul>
<li>商户余额支付退款 支持多笔退款</li>
</ul>
<p><strong>接口URL：</strong> </p>
<ul>
<li>测试<code>https://test.gdyfsk.com/yfpay/v3/refundYupay</code></li>
<li>正式<code>https://open.gdyfsk.com/yfpay/v3/refundYupay</code></li>
</ul>
<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: 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;">M</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;">M</td>
<td style="text-align: left;">商户号</td>
<td>Y52211090004</td>
</tr>
<tr>
<td style="text-align: left;">pay_trace_no</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">M</td>
<td style="text-align: left;">请求流水号（在商户系统内唯一）</td>
<td>51c7d68424e5492199cf7f4734a2b977</td>
</tr>
<tr>
<td style="text-align: left;">pay_time</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">M</td>
<td style="text-align: left;">请求支付时间，yyyyMMddHHmmss格式</td>
<td>20181116155621</td>
</tr>
<tr>
<td style="text-align: left;">order_body</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">订单描述</td>
<td>苹果笔记本</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;">org_pay_trace_no</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">M</td>
<td style="text-align: left;">原余额支付流水号</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">total_amount</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">M</td>
<td style="text-align: left;">总分账金额，单位分</td>
<td>123</td>
</tr>
<tr>
<td style="text-align: left;">share_detail</td>
<td style="text-align: left;">object</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">分账详情，json格式的字符串</td>
<td>"{\"share_count\":\"2\",\"share_fee_mch\":\"851811130002\",\"share_array\":[{\"share_mch\":\"851811130002\",\"share_amount\":\"122\"},{\"share_mch\":\"851811130003\",\"share_amount\":\"322\"}]}"</td>
</tr>
<tr>
<td style="text-align: left;">-share_count</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">分账条目数</td>
<td>2</td>
</tr>
<tr>
<td style="text-align: left;">-share_fee_mch</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">承担手续费的商户</td>
<td>851811130002</td>
</tr>
<tr>
<td style="text-align: left;">-share_array</td>
<td style="text-align: left;">array</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">分账数组，json数组</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">--share_mch</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">分账商户号 share_type=1乐收赢商户号，share_type=2三方商户号</td>
<td>851811130002</td>
</tr>
<tr>
<td style="text-align: left;">--share_amount</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">分账金额，单位：分</td>
<td>122</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">M</td>
<td style="text-align: left;">签名字符串,拼装所有值不为空（为null不参与，空字符串参与）</td>
<td>51c7d68424e5492199cf7f4734a2b977</td>
</tr>
</tbody>
</table>
<p><code>备注1：</code> sign 字段传递参数按照字典序用&符号连接最后拼接机构key，UTF-8编码，32位md5加密转换， 示例：a=1&b=1&c=1&d=1&key=51c7d68424e5492199cf7f4734a2b977，详细见 [接入指引](<a href="https://www.showdoc.com.cn/leshouying/10788371225650114">https://www.showdoc.com.cn/leshouying/10788371225650114</a> "接入指引")</p>
<p><strong>请求示例：</strong></p>
<pre><code class="language-json">{
&quot;inst_no&quot;: &quot;900189&quot;,
&quot;mch_no&quot;: &quot;Y52404190088&quot;,
&quot;notify_url&quot;: &quot;https://open.gdyfsk.com/yfpay/test/notify&quot;,
&quot;order_body&quot;: &quot;休休分账&quot;,
&quot;pay_time&quot;: &quot;20240511164236&quot;,
&quot;pay_trace_no&quot;: &quot;20000235464324051110471610121&quot;,
&quot;org_pay_trace_no&quot;: &quot;20000235464324051110471610121&quot;,
&quot;share_detail&quot;: &quot;{\&quot;share_count\&quot;:\&quot;1\&quot;,\&quot;share_fee_mch\&quot;:\&quot;851811130002\&quot;,\&quot;share_array\&quot;:[{\&quot;share_mch\&quot;:\&quot;6666000150405756\&quot;,\&quot;share_amount\&quot;:\&quot;1\&quot;}]}&quot;,
&quot;total_amount&quot;: &quot;1&quot;,
&quot;attach&quot;: &quot;8888&quot;,
&quot;sign&quot;: &quot;eaac36580153b2050f647ad6271e7953&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</td>
<td style="text-align: left;">M</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</td>
<td style="text-align: left;">M</td>
<td style="text-align: left;">返回信息提示，“退款成功”，“退款失败”，“参数不合法” 等</td>
<td>退款成功</td>
</tr>
<tr>
<td style="text-align: left;">result_code</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">C</td>
<td style="text-align: left;">业务结果：PAY_SUCCESS 退款成功 ，PAY_FAIL 退款失败，只有在return_code为SUCCESS时才会返回。</td>
<td>PAY_SUCCESS</td>
</tr>
<tr>
<td style="text-align: left;">mch_no</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">O</td>
<td style="text-align: left;">商户号</td>
<td>Y52211090004</td>
</tr>
<tr>
<td style="text-align: left;">mch_name</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">O</td>
<td style="text-align: left;">商户名称</td>
<td>银飞测试</td>
</tr>
<tr>
<td style="text-align: left;">pay_trace_no</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">M</td>
<td style="text-align: left;">请求流水号（必须在商户系统内唯一）</td>
<td>51c7d68424e5492199cf7f4734a2b977</td>
</tr>
<tr>
<td style="text-align: left;">org_pay_trace_no</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">M</td>
<td style="text-align: left;">原余额支付流水号</td>
<td>51c7d68424e5492199cf7f4734a2b977</td>
</tr>
<tr>
<td style="text-align: left;">pay_time</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">M</td>
<td style="text-align: left;">请求交易时间，yyyyMMddHHmmss</td>
<td>20181116155621</td>
</tr>
<tr>
<td style="text-align: left;">trade_no</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">M</td>
<td style="text-align: left;">订单号</td>
<td>20000002814118090716435200001</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</td>
<td style="text-align: left;">M</td>
<td style="text-align: left;">签名字符串，拼装所有传递参数，UTF-8编码，32位md5加密转换签名字符串</td>
<td>51c7d68424e5492199cf7f4734a2b977</td>
</tr>
</tbody>
</table>
<p><strong>返回示例：</strong></p>
<p>成功返回内容：</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;16&quot;,
&quot;mch_name&quot;: &quot;休休分账&quot;,
&quot;mch_no&quot;: &quot;Y52404190088&quot;,
&quot;pay_trace_no&quot;: &quot;20000235464324051110471610121&quot;,
&quot;pay_time&quot;: &quot;20240511164236&quot;,
&quot;total_amount&quot;: &quot;1&quot;,
&quot;end_time&quot;: null,
&quot;trade_no&quot;: &quot;003500TOP3A240511164343P855ac139ced00000&quot;,
&quot;attach&quot;: &quot;8888&quot;,
&quot;sign&quot;: &quot;dcca2a87524d6e044d772c1dbfa43564&quot;
}</code></pre>