用户业务入驻
<p><strong>接口描述：</strong> </p>
<ul>
<li>开户成功需要使用该接口完善卡信息，结算信息。 对接流程：开户-业务入驻-余额支付</li>
</ul>
<p><strong>接口URL：</strong> </p>
<ul>
<li>测试<code>https://test.gdyfsk.com/yfpay/user/busi/open&quot;</code></li>
<li>正式<code>https://open.gdyfsk.com/yfpay/user/busi/open&quot;</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;">channel_acct_no</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">M</td>
<td style="text-align: left;">渠道商户号</td>
<td>6666124212551</td>
</tr>
<tr>
<td style="text-align: left;">upper_channel_acct_no</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">M</td>
<td style="text-align: left;">服务商编号</td>
<td>6666124212448</td>
</tr>
<tr>
<td style="text-align: left;">settle_config</td>
<td style="text-align: left;">string</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_abstract</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;">--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;">string</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;">card_info</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">M</td>
<td style="text-align: left;">结算卡信息配置 - jsonObject格式</td>
<td>{}</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;">cash_config</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">M</td>
<td style="text-align: left;">取现配置列表 - jsonArray格式</td>
<td>[{},{}]</td>
</tr>
<tr>
<td style="text-align: left;">--switch_state</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">开通状态</td>
<td>0:关闭 1:开通;示例值:1</td>
</tr>
<tr>
<td style="text-align: left;">--cash_type</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">业务类型</td>
<td>T1:下一工作日到银行账户；DM：当日到账；到账资金不包括当天的交易资金；示例值：T1</td>
</tr>
<tr>
<td style="text-align: left;">--fix_amt</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">提现手续费（固定/元）</td>
<td>fix_amt与fee_rate至少填写一项， 需保留小数点后两位，不收费请填写0.00；示例值：1.00注：当cash_type=D1时为节假日取现手续费</td>
</tr>
<tr>
<td style="text-align: left;">--fee_rate</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">提现手续费率（%）</td>
<td>fix_amt与fee_rate至少填写一项，需保留小数点后两位，取值范围[0.00,100.00]，不收费请填写0.00；示例值：0.05注：1、如果fix_amt与fee_rate都填写了则手续费=fix_amt+支付金额*fee_rate2、当cash_type=D1时为节假日取现手续费</td>
</tr>
<tr>
<td style="text-align: left;">--weekday_fix_amt</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">D1工作日取现手续费固定金额</td>
<td>单位元，需保留小数点后两位。不收费请填写0.00；示例值：1.00 D1取现配置时选填，其他取现配置无效；cash_type取现类型为D1时，遇工作日按此费率结算，若未配置则默认按照节假日手续费计算</td>
</tr>
<tr>
<td style="text-align: left;">--weekday_fee_rate</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">D1工作日取现手续费率</td>
<td>单位%，需保留小数点后两位。取值范围[0.00，100.00]，不收费请填写0.00；示例值：0.05 D1取现配置时选填，其他取现配置无效；cash_type取现类型为D1时，遇工作日按此费率结算 ，若未配置则默认按照节假日手续费计算</td>
</tr>
<tr>
<td style="text-align: left;">--out_fee_flag</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">是否交易手续费外扣</td>
<td>1:外扣 2:内扣（默认2内扣）；示例值：1</td>
</tr>
<tr>
<td style="text-align: left;">--out_fee_huifu_id</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">手续费承担方</td>
<td>手续费外扣时必需指定手续费承担方ID；示例值：6666000123123123</td>
</tr>
<tr>
<td style="text-align: left;">--out_fee_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； 示例值：01</td>
</tr>
<tr>
<td style="text-align: left;">--is_priority_receipt</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">是否优先到账</td>
<td>Y：是 ，N：否。不填，默认值为否。仅在取现类型配置为D1 和 T1 时生效。示例值：Y</td>
</tr>
<tr>
<td style="text-align: left;">file_list</td>
<td style="text-align: left;">string</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>
<tr>
<td style="text-align: left;">open_tax_flag</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">N：否（默认） Y：是；示例值：Y</td>
<td>Y</td>
</tr>
<tr>
<td style="text-align: left;">delay_flag</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">延迟入账开关 N：否 Y：是；示例值：Y</td>
<td>Y</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 字段传递参数按照字典序用&符号连接最后拼接机构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;60000001&quot;,
&quot;merchant_no&quot;: &quot;852408270001&quot;,
&quot;channel_acct_no&quot;: &quot;6666000154535228&quot;,
&quot;upper_channel_acct_no&quot;: &quot;6666000148190435&quot;,
&quot;settle_config&quot;: {
&quot;settle_status&quot;: &quot;1&quot;,
&quot;settle_cycle&quot;: &quot;D1&quot;,
&quot;out_settle_flag&quot;: &quot;2&quot;,
&quot;min_amt&quot;: &quot;30.00&quot;,
&quot;remained_amt&quot;: &quot;30.00&quot;,
&quot;workday_fixed_ratio&quot;:&quot;30.00&quot;,
&quot;fixed_ratio&quot;:&quot;30.00&quot;
},
&quot;card_info&quot;: {
&quot;card_type&quot;: &quot;1&quot;,
&quot;card_name&quot;: &quot;黄伟吉&quot;,
&quot;card_no&quot;: &quot;6217003320104816650&quot;,
&quot;prov_id&quot;: &quot;440000&quot;,
&quot;area_id&quot;: &quot;440100&quot;
},
&quot;cash_config&quot;: [{
&quot;cash_type&quot;: &quot;T1&quot;,
&quot;switch_state&quot;: 1,
&quot;fix_amt&quot;: &quot;30.00&quot;,
&quot;fee_rate&quot;: &quot;30.00&quot;,
&quot;out_fee_flag&quot;: &quot;2&quot;
}],
&quot;sign&quot;: &quot;2f8d000ec251e6533e25fdbfafbf631b&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>
</tbody>
</table>
<p><strong>返回示例：</strong></p>
<p>成功返回内容：</p>
<pre><code class="language-json">{
&quot;token_no&quot;: &quot;10044213935&quot;,
&quot;code&quot;: &quot;000000&quot;,
&quot;apply_no&quot;: null,
&quot;resp_business&quot;: [
{
&quot;code&quot;: &quot;S&quot;,
&quot;type&quot;: &quot;1&quot;
},
{
&quot;code&quot;: &quot;S&quot;,
&quot;type&quot;: &quot;3&quot;
},
{
&quot;code&quot;: &quot;S&quot;,
&quot;type&quot;: &quot;2&quot;
},
{
&quot;code&quot;: &quot;S&quot;,
&quot;type&quot;: &quot;5&quot;
}
],
&quot;channel_acct_no&quot;: &quot;6666000154535228&quot;,
&quot;message&quot;: &quot;操作成功&quot;
}</code></pre>