进件接口
<h5>简要描述</h5>
<ul>
<li>资料上传接口</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>https://www.yinsufu.com/api/mchnt/mchntAdd</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>POST </li>
</ul>
<h5>参数</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
<th>举例参数</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">ins_cd</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>机构号</td>
<td>88230271</td>
</tr>
<tr>
<td style="text-align: left;">out_store_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>企管唯一商户号</td>
<td>S2024102256561236</td>
</tr>
<tr>
<td style="text-align: left;">mchnt_name</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>商户全称</td>
<td>测试名称(同营业执照名称)</td>
</tr>
<tr>
<td style="text-align: left;">mchnt_shortname</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>商户简称</td>
<td>测试简称</td>
</tr>
<tr>
<td style="text-align: left;">business</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>商户类目</td>
<td>4214(mcc表格编号)</td>
</tr>
<tr>
<td style="text-align: left;">real_name</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>营业执照名称</td>
<td>营业执照名称</td>
</tr>
<tr>
<td style="text-align: left;">license_type</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>证件类型(0:企业 1:个体 2:小微)</td>
<td>1</td>
</tr>
<tr>
<td style="text-align: left;">license_no</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>营业执照编号</td>
<td>92370681MAC42LHQ1Y(小微无需上传此字段)</td>
</tr>
<tr>
<td style="text-align: left;">license_expire_st</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>营业执照注册日期</td>
<td>2022-12-13(小微无需上传此字段)</td>
</tr>
<tr>
<td style="text-align: left;">license_expire_dt</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>营业执照到期日期</td>
<td>长期传参:2099-12-31(小微无需上传此字段)</td>
</tr>
<tr>
<td style="text-align: left;">license_address</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>营业执照地址</td>
<td>需按照营业执照填写</td>
</tr>
<tr>
<td style="text-align: left;">certif_type</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>证件类型</td>
<td>1 (仅支持身份证 1:表示身份证)</td>
</tr>
<tr>
<td style="text-align: left;">certif_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>法人身份证号</td>
<td>370681198610106840</td>
</tr>
<tr>
<td style="text-align: left;">certif_id_start_expire_dt</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>法人身份证开始时间</td>
<td>2018-01-16</td>
</tr>
<tr>
<td style="text-align: left;">certif_id_end_expire_dt</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>法人身份证结束时间</td>
<td>2038-01-16</td>
</tr>
<tr>
<td style="text-align: left;">login_number</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>登录账号</td>
<td>aa18655890817</td>
</tr>
<tr>
<td style="text-align: left;">contact_person</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>联系人姓名</td>
<td>张三</td>
</tr>
<tr>
<td style="text-align: left;">contact_phone</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>联系人手机号</td>
<td>18655890817</td>
</tr>
<tr>
<td style="text-align: left;">contact_addr</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>经营详细地址</td>
<td>某某街道某某办事处(经营详细地址)</td>
</tr>
<tr>
<td style="text-align: left;">county_cd</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>经营地区(县级地区代码)</td>
<td>1125(经营地区,地区表格编号)</td>
</tr>
<tr>
<td style="text-align: left;">acnt_type</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>入账卡类型</td>
<td>01(对私法人)02(对公)03(对私非法人)</td>
</tr>
<tr>
<td style="text-align: left;">iss_bank_nm</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>开户行名称</td>
<td>中国工商银行股份有限公司上海市崂山东路支行(可不传,为银行编码表支行名称)</td>
</tr>
<tr>
<td style="text-align: left;">acnt_nm</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>入账卡户名</td>
<td>曹美玉(入账卡类型对私为法人名称,对公为营业执照名称)</td>
</tr>
<tr>
<td style="text-align: left;">acnt_no</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>入账卡号</td>
<td>6222031606012395613(入账卡类型对私为银行卡号,对公为开户许可证编号)</td>
</tr>
<tr>
<td style="text-align: left;">bank_code</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>联行号</td>
<td>16516(银行表格,联行号)</td>
</tr>
<tr>
<td style="text-align: left;">public_act_img_id</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>开户许可证</td>
<td>165165(对公结算才需要,上传该图片)</td>
</tr>
<tr>
<td style="text-align: left;">artif_nm</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>法人名称</td>
<td>张三</td>
</tr>
<tr>
<td style="text-align: left;">bank_head</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>结算人名称</td>
<td>李四(对私非法人需要)</td>
</tr>
<tr>
<td style="text-align: left;">hold_start_expire_dt</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>结算人身份证开始时间</td>
<td>2018-01-16(对私非法人才需要)</td>
</tr>
<tr>
<td style="text-align: left;">hold_end_expire_dt</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>结算人身份证结束时间</td>
<td>2099-12-31(对私非法人才需要,长期传2099否则正常年月日)</td>
</tr>
<tr>
<td style="text-align: left;">hold_certif_id</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>结算人身份证号</td>
<td>370681198610106840(非法人进件才需要)</td>
</tr>
<tr>
<td style="text-align: left;">store_pic_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>门头照id</td>
<td>图片上传接口返回id</td>
</tr>
<tr>
<td style="text-align: left;">inside_pic_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>内景照id</td>
<td>图片上传接口返回id</td>
</tr>
<tr>
<td style="text-align: left;">cashier_pic_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>收银台照片id</td>
<td>图片上传接口返回id</td>
</tr>
<tr>
<td style="text-align: left;">bank_card_positive_pic_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>银行卡正面id</td>
<td>图片上传接口返回id</td>
</tr>
<tr>
<td style="text-align: left;">bank_card_opposite_pic_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>银行卡反面id</td>
<td>图片上传接口返回id</td>
</tr>
<tr>
<td style="text-align: left;">license_pic_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>营业执照照片id</td>
<td>图片上传接口返回id</td>
</tr>
<tr>
<td style="text-align: left;">legal_person_positive_pic_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>法人身份证正面id</td>
<td>图片上传接口返回id</td>
</tr>
<tr>
<td style="text-align: left;">legal_person_opposite_pic_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>法人身份证反面id</td>
<td>图片上传接口返回id</td>
</tr>
<tr>
<td style="text-align: left;">hand_person_positive_pic_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>手持身份证正面id</td>
<td>图片上传接口返回id</td>
</tr>
<tr>
<td style="text-align: left;">letter_of_auth_pic_id</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>授权函照片id(对私非法人结算需要)</td>
<td>图片上传接口返回id</td>
</tr>
<tr>
<td style="text-align: left;">hold_certif_positive_pic_id</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>结算人身份证正面照片id(对私非法人结算需要)</td>
<td>图片上传接口返回id</td>
</tr>
<tr>
<td style="text-align: left;">hold_certif_opposite_pic_id</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>结算人身份证反面照片id(对私非法人结算需要)</td>
<td>图片上传接口返回id</td>
</tr>
<tr>
<td style="text-align: left;">other_pic_one</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>其他照片1</td>
<td>图片上传接口返回id</td>
</tr>
<tr>
<td style="text-align: left;">other_pic_two</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>其他照片2</td>
<td>图片上传接口返回id</td>
</tr>
<tr>
<td style="text-align: left;">other_pic_three</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>其他照片3</td>
<td>图片上传接口返回id</td>
</tr>
<tr>
<td style="text-align: left;">company</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>入网通道</td>
<td>随行付:01 富友:02 拉卡拉:03 盛富通:04</td>
</tr>
<tr>
<td style="text-align: left;">settle_type</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>清算类型</td>
<td>D0:秒到 D1:次日结算(秒到不支持定时结算)</td>
</tr>
<tr>
<td style="text-align: left;">settlement_type</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>清算方式</td>
<td>1:自动结算 2:定时结算</td>
</tr>
<tr>
<td style="text-align: left;">settle_ts</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>清算时间</td>
<td>12 (比如12,就是第二天12点清算)</td>
</tr>
<tr>
<td style="text-align: left;">fee_rate</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">json</td>
<td>费率参数</td>
<td>{"wechat":"0.38","alipay":"0.38","bank_lend":"0.38","bank_loan":"0.38","bank_loan_big":"0.38","bank_lend_big":"0.38","swipe_credit":"0.38","swipe_debit":"0.38"}(wechat:微信支付费率;alipay:支付宝支付费率;bank_lend:云闪付借记卡费率1000以下;bank_loan:云闪付信用卡费率1000以下;bank_loan_big:云闪付信用卡费率1000以上;bank_lend_big:云闪付借记卡费率1000以上;swipe_credit:刷卡-信用卡费率;swipe_debit:刷卡-借记卡费率)</td>
</tr>
<tr>
<td style="text-align: left;">notify_url</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>回调地址</td>
<td><a href="https://www.yinsufu.com/mb/index">https://www.yinsufu.com/mb/index</a></td>
</tr>
<tr>
<td style="text-align: left;">public_bank_nm</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>对公账户-开户行名称(新增,用于盛付通通道企业类型的对私法人和非法人结算时需要上传的)</td>
<td>中国工商银行股份有限公司上海市崂山东路支行</td>
</tr>
<tr>
<td style="text-align: left;">public_acnt_nm</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>对公账户-对公账户户名(新增,用于盛付通通道企业类型的对私法人和非法人结算时需要上传的)</td>
<td>与执照名一致</td>
</tr>
<tr>
<td style="text-align: left;">public_bank_no</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>对公账户-对公户账号(新增,用于盛付通通道企业类型的对私法人和非法人结算时需要上传的)</td>
<td>123456</td>
</tr>
<tr>
<td style="text-align: left;">public_bank_code</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>对公账户-银行联行号(新增,用于盛付通通道企业类型的对私法人和非法人结算时需要上传的)</td>
<td>123456</td>
</tr>
<tr>
<td style="text-align: left;">firm_bank_positive_pic_id</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>法人银行卡正面id(新增,用于盛付通通道个体类型非法人结算时需要上传的)</td>
<td>图片上传接口返回id</td>
</tr>
<tr>
<td style="text-align: left;">firm_bank_opposite_pic_id</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>法人银行卡反面id(新增,用于盛付通通道个体类型非法人结算时需要上传的)</td>
<td>图片上传接口返回id</td>
</tr>
<tr>
<td style="text-align: left;">firm_bank_nm</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>法人银行卡开户行名称(新增,用于盛付通通道个体类型非法人结算时需要上传的)</td>
<td>中国工商银行股份有限公司上海市崂山东路支行</td>
</tr>
<tr>
<td style="text-align: left;">firm_bank_no</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>法人银行卡卡号 (新增,用于盛付通通道个体类型非法人结算时需要上传的)</td>
<td>622*<strong>**</strong>(法人姓名请传artif_nm字段)</td>
</tr>
<tr>
<td style="text-align: left;">firm_bank_code</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>法人银行卡联行号(新增,用于盛付通通道个体类型非法人结算时需要上传的)</td>
<td>123456</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<pre><code> {
&quot;error_code&quot;: 0,
&quot;data&quot;: {
&quot;store_id&quot;: &quot;1&quot;,
&quot;status&quot;: &quot;2&quot;,
}
}</code></pre>
<h5>返回参数说明</h5>
<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;">store_id</td>
<td style="text-align: left;">int</td>
<td>中台商户号</td>
</tr>
<tr>
<td style="text-align: left;">status</td>
<td style="text-align: left;">int</td>
<td>审核状态(1:审核通过 2:审核中 3:审核失败)</td>
</tr>
</tbody>
</table>
<h5>备注</h5>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>