银速付进件接口

银速付进件接口


进件接口

<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>{&quot;wechat&quot;:&quot;0.38&quot;,&quot;alipay&quot;:&quot;0.38&quot;,&quot;bank_lend&quot;:&quot;0.38&quot;,&quot;bank_loan&quot;:&quot;0.38&quot;,&quot;bank_loan_big&quot;:&quot;0.38&quot;,&quot;bank_lend_big&quot;:&quot;0.38&quot;,&quot;swipe_credit&quot;:&quot;0.38&quot;,&quot;swipe_debit&quot;:&quot;0.38&quot;}(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> { &amp;quot;error_code&amp;quot;: 0, &amp;quot;data&amp;quot;: { &amp;quot;store_id&amp;quot;: &amp;quot;1&amp;quot;, &amp;quot;status&amp;quot;: &amp;quot;2&amp;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>

页面列表

ITEM_HTML