乐收赢API

银飞乐收赢接口文档


提交分账信息

<p><strong>接口描述:</strong> </p> <ul> <li>用于记录分账信息,到账当天执行前一天的所有分账信息</li> </ul> <p><strong>接口URL:</strong> </p> <ul> <li>测试<code>https://test.gdyfsk.com/yfpay/v3/yupay</code></li> <li>正式<code>https://open.gdyfsk.com/yfpay/v3/yupay</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;">notify_url</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;">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;">trade_channel_id</td> <td style="text-align: left;">string</td> <td style="text-align: left;"></td> <td style="text-align: left;">交易通道id</td> <td>16-汇付 具体需要联系客户经理</td> </tr> <tr> <td style="text-align: left;">pay_income_type</td> <td style="text-align: left;">string</td> <td style="text-align: left;"></td> <td style="text-align: left;">资金入金类型</td> <td>1:交易入金 2:充值入金</td> </tr> <tr> <td style="text-align: left;">split_time</td> <td style="text-align: left;">string</td> <td style="text-align: left;"></td> <td style="text-align: left;">分账时间</td> <td>yyyy-MM-dd HH:mm:ss</td> </tr> <tr> <td style="text-align: left;">share_type</td> <td style="text-align: left;">string</td> <td style="text-align: left;">M</td> <td style="text-align: left;">1.乐收赢分账 2.三方分账,不传默认0</td> <td>share_type=1</td> </tr> <tr> <td style="text-align: left;">share_detail</td> <td style="text-align: left;">object</td> <td style="text-align: left;">M</td> <td style="text-align: left;">分账详情,json格式的字符串</td> <td>&quot;{\&quot;share_count\&quot;:\&quot;2\&quot;,\&quot;share_fee_mch\&quot;:\&quot;851811130002\&quot;,\&quot;share_array\&quot;:[{\&quot;share_mch\&quot;:\&quot;851811130002\&quot;,\&quot;share_amount\&quot;:\&quot;122\&quot;},{\&quot;share_mch\&quot;:\&quot;851811130003\&quot;,\&quot;share_amount\&quot;:\&quot;322\&quot;}]}&quot;</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;">share_effect_time</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;">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 字段传递参数按照字典序用&amp;符号连接最后拼接机构key,UTF-8编码,32位md5加密转换, 示例:a=1&amp;b=1&amp;c=1&amp;d=1&amp;key=51c7d68424e5492199cf7f4734a2b977,详细见 [接入指引](<a href="https://www.showdoc.com.cn/leshouying/10788371225650114">https://www.showdoc.com.cn/leshouying/10788371225650114</a> &quot;接入指引&quot;)</p> <p><strong>请求示例:</strong></p> <pre><code class="language-json">{     &amp;quot;inst_no&amp;quot;: &amp;quot;900189&amp;quot;,     &amp;quot;mch_no&amp;quot;: &amp;quot;Y52404190088&amp;quot;,     &amp;quot;notify_url&amp;quot;: &amp;quot;https://open.gdyfsk.com/yfpay/test/notify&amp;quot;,     &amp;quot;order_body&amp;quot;: &amp;quot;休休分账&amp;quot;,     &amp;quot;pay_time&amp;quot;: &amp;quot;20240511164236&amp;quot;,     &amp;quot;pay_trace_no&amp;quot;: &amp;quot;20000235464324051110471610121&amp;quot;,     &amp;quot;share_detail&amp;quot;: &amp;quot;{\&amp;quot;share_count\&amp;quot;:\&amp;quot;1\&amp;quot;,\&amp;quot;share_fee_mch\&amp;quot;:\&amp;quot;851811130002\&amp;quot;,\&amp;quot;share_array\&amp;quot;:[{\&amp;quot;share_mch\&amp;quot;:\&amp;quot;6666000150405756\&amp;quot;,\&amp;quot;share_amount\&amp;quot;:\&amp;quot;1\&amp;quot;}]}&amp;quot;,     &amp;quot;share_effect_time&amp;quot;: &amp;quot;1&amp;quot;,     &amp;quot;share_type&amp;quot;: &amp;quot;2&amp;quot;,     &amp;quot;total_amount&amp;quot;: &amp;quot;1&amp;quot;,      &amp;quot;attach&amp;quot;: &amp;quot;8888&amp;quot;,     &amp;quot;sign&amp;quot;: &amp;quot;eaac36580153b2050f647ad6271e7953&amp;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_IN_PROCESS 支付中 ,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;">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">{     &amp;quot;return_code&amp;quot;: &amp;quot;SUCCESS&amp;quot;,     &amp;quot;return_msg&amp;quot;: &amp;quot;余额支付成功&amp;quot;,     &amp;quot;result_code&amp;quot;: &amp;quot;PAY_SUCCESS&amp;quot;,     &amp;quot;pay_type&amp;quot;: &amp;quot;16&amp;quot;,     &amp;quot;mch_name&amp;quot;: &amp;quot;休休分账&amp;quot;,     &amp;quot;mch_no&amp;quot;: &amp;quot;Y52404190088&amp;quot;,     &amp;quot;pay_trace_no&amp;quot;: &amp;quot;20000235464324051110471610121&amp;quot;,     &amp;quot;pay_time&amp;quot;: &amp;quot;20240511164236&amp;quot;,     &amp;quot;total_amount&amp;quot;: &amp;quot;1&amp;quot;,     &amp;quot;end_time&amp;quot;: null,     &amp;quot;trade_no&amp;quot;: &amp;quot;003500TOP3A240511164343P855ac139ced00000&amp;quot;,     &amp;quot;attach&amp;quot;: &amp;quot;8888&amp;quot;,     &amp;quot;sign&amp;quot;: &amp;quot;dcca2a87524d6e044d772c1dbfa43564&amp;quot; }</code></pre>

页面列表

ITEM_HTML