乐收赢API

银飞乐收赢接口文档


用户信息查询

<p><strong>接口描述:</strong> </p> <ul> <li>查询账户信息</li> </ul> <p><strong>接口URL:</strong> </p> <ul> <li>测试<code>https://test.gdyfsk.com/yfpay/user/basicdata/query</code></li> <li>正式<code>https://open.gdyfsk.com/yfpay/user/basicdata/query</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;">merchant_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;">sign</td> <td style="text-align: left;">string</td> <td style="text-align: left;">M</td> <td style="text-align: left;">签名</td> <td>adadahadjahajdakdjk</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;60000001&amp;quot;,     &amp;quot;merchant_no&amp;quot;: &amp;quot;852405310001&amp;quot;,     &amp;quot;sign&amp;quot;: &amp;quot;7aba7acc37d79babcd28347bc2104f78&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;">code</td> <td style="text-align: left;">string</td> <td style="text-align: left;">M</td> <td style="text-align: left;">响应码:000000成功,其他失败,</td> <td>0000000</td> </tr> <tr> <td style="text-align: left;">qry_cash_card_info_list</td> <td style="text-align: left;">jsonobject</td> <td style="text-align: left;">M</td> <td style="text-align: left;">取现卡交易</td> </tr> <tr> <td style="text-align: left;">--card_type</td> <td style="text-align: left;">string</td> <td style="text-align: left;">M</td> <td style="text-align: left;">卡类型</td> <td>0:对公,1:对私,2:对私非法人;个人商户/用户不支持对公类型,对私非法人类型示例值:0</td> </tr> <tr> <td style="text-align: left;">--card_name</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;">--card_no</td> <td style="text-align: left;">string</td> <td style="text-align: left;">M</td> <td style="text-align: left;">卡号</td> <td>银行卡号;示例值:0206014170008888</td> </tr> <tr> <td style="text-align: left;">--prov_id</td> <td style="text-align: left;">string</td> <td style="text-align: left;">M</td> <td style="text-align: left;">银行所在省</td> <td>示例值:100000</td> </tr> <tr> <td style="text-align: left;">--area_id</td> <td style="text-align: left;">string</td> <td style="text-align: left;">M</td> <td style="text-align: left;">银行所在市</td> <td>示例值:100000</td> </tr> <tr> <td style="text-align: left;">--bank_code</td> <td style="text-align: left;">string</td> <td style="text-align: left;"></td> <td style="text-align: left;">银行号</td> <td>当card_type=0时必填,对私可以为空 示例值:01040000</td> </tr> <tr> <td style="text-align: left;">--branch_code</td> <td style="text-align: left;">string</td> <td style="text-align: left;"></td> <td style="text-align: left;">支行联行号</td> <td>当card_type=0时必填,点击查看;示例值:103124075619</td> </tr> <tr> <td style="text-align: left;">--cert_type</td> <td style="text-align: left;">string</td> <td style="text-align: left;"></td> <td style="text-align: left;">持卡人证件类型</td> <td>对私必填;说明;示例值:00(身份证)</td> </tr> <tr> <td style="text-align: left;">--cert_no</td> <td style="text-align: left;">string</td> <td style="text-align: left;"></td> <td style="text-align: left;">持卡人证件号码</td> <td>对私必填; 如:证件类型为身份证, 则填写身份证号码;示例值:32092619841203205</td> </tr> <tr> <td style="text-align: left;">--cert_validity_type</td> <td style="text-align: left;">string</td> <td style="text-align: left;"></td> <td style="text-align: left;">持卡人证件有效期类型</td> <td>对私必填;1:长期有效;0:非长期有效;示例值:0</td> </tr> <tr> <td style="text-align: left;">--cert_begin_date</td> <td style="text-align: left;">string</td> <td style="text-align: left;"></td> <td style="text-align: left;">持卡人证件有效期(起始)</td> <td>对私必填;日期格式:yyyyMMdd,示例值:20110112</td> </tr> <tr> <td style="text-align: left;">--cert_end_date</td> <td style="text-align: left;">string</td> <td style="text-align: left;"></td> <td style="text-align: left;">持卡人证件有效期(截止)</td> <td>当cert_validity_type=0时必须填写;日期格式yyyyMMdd,示例值:20110112当cert_validity_type=1可不填</td> </tr> <tr> <td style="text-align: left;">--mp</td> <td style="text-align: left;">string</td> <td style="text-align: left;"></td> <td style="text-align: left;">银行卡绑定手机号</td> <td>11位数字,示例值:18611111111</td> </tr> <tr> <td style="text-align: left;">settle_config</td> <td style="text-align: left;">jsonObject</td> <td style="text-align: left;">M</td> <td style="text-align: left;">结算卡信息 - jsonObject格式</td> <td>{}</td> </tr> <tr> <td style="text-align: left;">--settle_cycle</td> <td style="text-align: left;">string</td> <td style="text-align: left;">M</td> <td style="text-align: left;">结算周期</td> <td>T1:下个工作日到账;D1:下个自然日到账;示例值:T1</td> </tr> <tr> <td style="text-align: left;">--out_settle_flag</td> <td style="text-align: left;">string</td> <td style="text-align: left;">M</td> <td style="text-align: left;">手续费外扣标记</td> <td>1:外扣;2:内扣(为空时默认值);示例值:1</td> </tr> <tr> <td style="text-align: left;">--out_settle_huifuid</td> <td style="text-align: left;">string</td> <td style="text-align: left;"></td> <td style="text-align: left;">结算手续费外扣时的汇渠道商户号</td> <td>6666124212551</td> </tr> <tr> <td style="text-align: left;">--out_settle_acct_type</td> <td style="text-align: left;">string</td> <td style="text-align: left;"></td> <td style="text-align: left;">结算手续费外扣时的账户类型</td> <td>外扣手续费账户类型; 01:基本户(为空时默认值), 05:充值户;外扣时必填;示例值:01</td> </tr> <tr> <td style="text-align: left;">--settle_pattern</td> <td style="text-align: left;">string</td> <td style="text-align: left;"></td> <td style="text-align: left;">结算方式</td> <td>P0:批次结算(为空时默认值), P1:定时结算;示例值:P0</td> </tr> <tr> <td style="text-align: left;">--settle_batch_no</td> <td style="text-align: left;">string</td> <td style="text-align: left;"></td> <td style="text-align: left;">结算批次号</td> <td>settle_pattern为P0时必填;参见结算批次说明</td> </tr> <tr> <td style="text-align: left;">--is_priority_receipt</td> <td style="text-align: left;">jsonObject</td> <td style="text-align: left;"></td> <td style="text-align: left;">是否优先到账</td> <td>settle_pattern为P0时选填, Y:是 N:否(为空默认取值);示例值:Y</td> </tr> <tr> <td style="text-align: left;">--settle_time</td> <td style="text-align: left;">string</td> <td style="text-align: left;"></td> <td style="text-align: left;">自定义结算处理时间</td> <td>settle_pattern为P1时必填,注意:00:00到00:30不能指定;格式:HHmmss;示例值:103000</td> </tr> <tr> <td style="text-align: left;">--fixed_ratio</td> <td style="text-align: left;">string</td> <td style="text-align: left;"></td> <td style="text-align: left;">节假日结算手续费率</td> <td>settle_cycle为D1时必填。单位%,需保留小数点后两位。取值范围[0.00,100.00],不收费请填写0.00;settle_cycle=T1时,不生效 ;settle_cycle为D1时,遇节假日按此费率结算 ;示例值:0.05</td> </tr> <tr> <td style="text-align: left;">--workday_fixed_ratio</td> <td style="text-align: left;">string</td> <td style="text-align: left;"></td> <td style="text-align: left;">工作日结算手续费率</td> <td>单位%,需保留小数点后两位。取值范围[0.00,100.00],不填默认为0.00;示例值:0.05</td> </tr> <tr> <td style="text-align: left;">--workday_constant_amt</td> <td style="text-align: left;">string</td> <td style="text-align: left;"></td> <td style="text-align: left;">工作日结算手续费固定金额</td> <td>单位元,需保留小数点后两位。不填默认为0.00;示例值:1.00</td> </tr> <tr> <td style="text-align: left;">file_list</td> <td style="text-align: left;">jsonArray</td> <td style="text-align: left;">M</td> <td style="text-align: left;">文件列表- jsonArray格式</td> <td>[{},{}]</td> </tr> <tr> <td style="text-align: left;">--file_type</td> <td style="text-align: left;">string(32)</td> <td style="text-align: left;">M</td> <td style="text-align: left;">乐收赢商户号</td> <td>小微身份证正面人像:F40 小微身份证反面国徽:F41 结算卡正面:F13 店铺门头照:F22 店铺内景:F2 店铺收银台:F105 营业执照证件:F07 法人正面人像:F02 法人反面国徽:F03 开户许可证:F08 对私卡正面:F13 对私身份证正面人像:F55 对私身份证反面国徽:F56 授权委托书:F15 上传就按照这个了</td> </tr> <tr> <td style="text-align: left;">--file_id</td> <td style="text-align: left;">string</td> <td style="text-align: left;">M</td> <td style="text-align: left;">文件jfileID</td> <td>图片上传接口生成的fileId;示例值:57cc7f00-600a-33ab-b614-6221bbf2e529</td> </tr> <tr> <td style="text-align: left;">--file_name</td> <td style="text-align: left;">string</td> <td style="text-align: left;">M</td> <td style="text-align: left;">文件名称</td> <td>示例值:test42001.jpg</td> </tr> </tbody> </table> <p><strong>返回示例:</strong></p> <p>成功返回内容:</p> <pre><code class="language-json">{ &amp;quot;code&amp;quot;: &amp;quot;000000&amp;quot;, &amp;quot;qry_cash_card_info_list&amp;quot;: &amp;quot;[{\&amp;quot;area_id\&amp;quot;:\&amp;quot;440100\&amp;quot;,\&amp;quot;bank_code\&amp;quot;:\&amp;quot;01050000\&amp;quot;,\&amp;quot;bank_name\&amp;quot;:\&amp;quot;中国建设银行\&amp;quot;,\&amp;quot;branch_code\&amp;quot;:\&amp;quot;\&amp;quot;,\&amp;quot;branch_name\&amp;quot;:\&amp;quot;\&amp;quot;,\&amp;quot;card_name\&amp;quot;:\&amp;quot;黄伟吉\&amp;quot;,\&amp;quot;card_no\&amp;quot;:\&amp;quot;6217003320104816650\&amp;quot;,\&amp;quot;card_type\&amp;quot;:\&amp;quot;1\&amp;quot;,\&amp;quot;cert_begin_date\&amp;quot;:\&amp;quot;20230530\&amp;quot;,\&amp;quot;cert_end_date\&amp;quot;:\&amp;quot;20430530\&amp;quot;,\&amp;quot;cert_no\&amp;quot;:\&amp;quot;450802199703070955\&amp;quot;,\&amp;quot;cert_type\&amp;quot;:\&amp;quot;00\&amp;quot;,\&amp;quot;cert_validity_type\&amp;quot;:\&amp;quot;0\&amp;quot;,\&amp;quot;is_settle_default\&amp;quot;:\&amp;quot;\&amp;quot;,\&amp;quot;mp\&amp;quot;:\&amp;quot;18664375458\&amp;quot;,\&amp;quot;prov_id\&amp;quot;:\&amp;quot;440000\&amp;quot;,\&amp;quot;status\&amp;quot;:\&amp;quot;N\&amp;quot;,\&amp;quot;token_no\&amp;quot;:\&amp;quot;10043959905\&amp;quot;}]&amp;quot;, &amp;quot;wallet&amp;quot;: { &amp;quot;id&amp;quot;: 155, &amp;quot;merchant_id&amp;quot;: 2393, &amp;quot;mch_no&amp;quot;: &amp;quot;852408130001&amp;quot;, &amp;quot;member_no&amp;quot;: &amp;quot;F03328998&amp;quot;, &amp;quot;total_balance&amp;quot;: 19, &amp;quot;available_balance&amp;quot;: 19, &amp;quot;withdrawal_balance&amp;quot;: 19, &amp;quot;member_type&amp;quot;: 1, &amp;quot;channel_id&amp;quot;: 16, &amp;quot;channel_type&amp;quot;: 16, &amp;quot;channel_name&amp;quot;: &amp;quot;汇付(银飞数智)&amp;quot;, &amp;quot;channel_acct_no&amp;quot;: &amp;quot;6666000154196846&amp;quot;, &amp;quot;status&amp;quot;: 1, &amp;quot;member_name&amp;quot;: &amp;quot;黄伟吉&amp;quot;, &amp;quot;member_nick_name&amp;quot;: &amp;quot;黄伟吉&amp;quot;, &amp;quot;global_type&amp;quot;: 1, &amp;quot;global_id&amp;quot;: &amp;quot;450802199703070955&amp;quot;, &amp;quot;bank_acct_name&amp;quot;: &amp;quot;黄伟吉&amp;quot;, &amp;quot;bank_acct_no&amp;quot;: &amp;quot;6217003320104816650&amp;quot;, &amp;quot;bank_type&amp;quot;: &amp;quot;2&amp;quot;, &amp;quot;acct_open_branch_name&amp;quot;: &amp;quot;中国建设银行&amp;quot;, &amp;quot;cnaps_branch_id&amp;quot;: &amp;quot;01050000&amp;quot;, &amp;quot;eicon_bank_branch_id&amp;quot;: null, &amp;quot;mobile&amp;quot;: null, &amp;quot;email&amp;quot;: null, &amp;quot;create_time&amp;quot;: 1723536381000, &amp;quot;update_time&amp;quot;: null, &amp;quot;token_no&amp;quot;: &amp;quot;10043959905&amp;quot;, &amp;quot;del_flag&amp;quot;: &amp;quot;0&amp;quot;, &amp;quot;agent1_id&amp;quot;: 100, &amp;quot;agent2_id&amp;quot;: 101, &amp;quot;bd_id&amp;quot;: 245, &amp;quot;pid&amp;quot;: 60 }, &amp;quot;file_list&amp;quot;: [ { &amp;quot;file_url&amp;quot;: &amp;quot;http://sb-merchant.oss-cn-hangzhou.aliyuncs.com/202408131603468770.jpg&amp;quot;, &amp;quot;file_type&amp;quot;: &amp;quot;F02&amp;quot; }, { &amp;quot;file_url&amp;quot;: &amp;quot;http://sb-merchant.oss-cn-hangzhou.aliyuncs.com/202408131603524242.jpg&amp;quot;, &amp;quot;file_type&amp;quot;: &amp;quot;F03&amp;quot; }, { &amp;quot;file_url&amp;quot;: &amp;quot;http://sb-merchant.oss-cn-hangzhou.aliyuncs.com/202408131603571010.jpg&amp;quot;, &amp;quot;file_type&amp;quot;: &amp;quot;F13&amp;quot; }, { &amp;quot;file_url&amp;quot;: &amp;quot;http://sb-merchant.oss-cn-hangzhou.aliyuncs.com/202408131604037724.jpg&amp;quot;, &amp;quot;file_type&amp;quot;: &amp;quot;F14&amp;quot; } ], &amp;quot;settle_config&amp;quot;: &amp;quot;{\&amp;quot;settle_pattern\&amp;quot;:\&amp;quot;P0\&amp;quot;}&amp;quot;, &amp;quot;message&amp;quot;: &amp;quot;操作成功&amp;quot;, &amp;quot;upper_huifu_id&amp;quot;: &amp;quot;6666000148190435&amp;quot;, &amp;quot;qry_cash_config_list&amp;quot;: &amp;quot;[{\&amp;quot;cash_type\&amp;quot;:\&amp;quot;DM\&amp;quot;,\&amp;quot;fee_rate\&amp;quot;:\&amp;quot;0.00\&amp;quot;,\&amp;quot;fix_amt\&amp;quot;:\&amp;quot;0.00\&amp;quot;,\&amp;quot;out_cash_flag\&amp;quot;:\&amp;quot;2\&amp;quot;,\&amp;quot;out_cash_huifuid\&amp;quot;:\&amp;quot;\&amp;quot;,\&amp;quot;switch_state\&amp;quot;:\&amp;quot;1\&amp;quot;}]&amp;quot;, &amp;quot;indv_base_info&amp;quot;: &amp;quot;{\&amp;quot;address\&amp;quot;:\&amp;quot;\&amp;quot;,\&amp;quot;cert_begin_date\&amp;quot;:\&amp;quot;20230530\&amp;quot;,\&amp;quot;cert_end_date\&amp;quot;:\&amp;quot;20430530\&amp;quot;,\&amp;quot;cert_no\&amp;quot;:\&amp;quot;450802199703070955\&amp;quot;,\&amp;quot;cert_type\&amp;quot;:\&amp;quot;00\&amp;quot;,\&amp;quot;cert_validity_type\&amp;quot;:\&amp;quot;0\&amp;quot;,\&amp;quot;file_list\&amp;quot;:[{\&amp;quot;file_id\&amp;quot;:\&amp;quot;403e9dc9-a4b5-309e-b4e5-3575103d3ca9\&amp;quot;,\&amp;quot;file_name\&amp;quot;:\&amp;quot;F02\&amp;quot;,\&amp;quot;file_type\&amp;quot;:\&amp;quot;F02\&amp;quot;},{\&amp;quot;file_id\&amp;quot;:\&amp;quot;b383d57d-cb1d-33d4-8ab7-9d9927edd2cb\&amp;quot;,\&amp;quot;file_name\&amp;quot;:\&amp;quot;F03\&amp;quot;,\&amp;quot;file_type\&amp;quot;:\&amp;quot;F03\&amp;quot;},{\&amp;quot;file_id\&amp;quot;:\&amp;quot;4ef037d2-e18c-32a7-9896-fb9482643b39\&amp;quot;,\&amp;quot;file_name\&amp;quot;:\&amp;quot;F13\&amp;quot;,\&amp;quot;file_type\&amp;quot;:\&amp;quot;F13\&amp;quot;},{\&amp;quot;file_id\&amp;quot;:\&amp;quot;49eb1ab3-225c-39be-8130-ad8b8f0c458b\&amp;quot;,\&amp;quot;file_name\&amp;quot;:\&amp;quot;F14\&amp;quot;,\&amp;quot;file_type\&amp;quot;:\&amp;quot;F14\&amp;quot;}],\&amp;quot;lg_config\&amp;quot;:{\&amp;quot;open_flag\&amp;quot;:\&amp;quot;N\&amp;quot;},\&amp;quot;mobile_no\&amp;quot;:\&amp;quot;18664375458\&amp;quot;,\&amp;quot;name\&amp;quot;:\&amp;quot;黄伟吉\&amp;quot;,\&amp;quot;occupation\&amp;quot;:\&amp;quot;\&amp;quot;,\&amp;quot;open_tax_flag\&amp;quot;:\&amp;quot;N\&amp;quot;,\&amp;quot;open_wallet_user_flag\&amp;quot;:\&amp;quot;\&amp;quot;,\&amp;quot;sex\&amp;quot;:\&amp;quot;\&amp;quot;}&amp;quot; }</code></pre>

页面列表

ITEM_HTML