门店创建及产品开通

简要描述：

该接口适用于商户入网（支持总分店连锁场景）：总店首次入网后，系统分配商户编号和门店编号；分店入网时，需传入上级商户编号，系统分配分店的门店编号
适用于入网审核失败或入网驳回后的修改提交（驳回仅支持修改照片资质，业务报备失败情况下可修改简称）；

请求URL:

测试环境：http://47.95.131.62:8080/api/v2/merchant/apply

请求参数(O-非必传 ,C-条件必传 ,M-必传)：

参数	参数名称	类型	参数说明	样例	可空
agent_no	服务商编号	String	服务商的编号，由SAAS平台分配，表示当前商户属于该服务商名下	88888888	M
agent_apply_no	服务商申请单号	String	服务商申请单号		M
merch_no	商户编号	String	首次入网不用填写，入驻分店时必填		C
store_id	门店编号	String	首次入网不用填写，入网失败或驳回后修改时必填		C
merch_type	门店类型	String	ENTERPRISE:企业 INDIVIDUAL:个体工商户 MICRO:小微商户 INSTITUTIONS_CLONED:事业单位 OTHERS:其他组织	ENTERPRISE	M
settlement_symbol	是否独立结算	String	00:是 01:否 merch_no为空时可不填，只能独立结算 merch_no有值时，不填默认独立结算		C
template_store_id	非独立报备门店编号	String	独立报备为空；非独立报备填写需使用的门店编号;需填写同一商户下的门店编号		C
merchant_data	商户主体信息	JSON	参考下表（商户信息：merchant_data）		M
merchant_corporation_data	商户法人信息	JSON	参考下表（商户法人信息：merchant_corporation_data）		M
merchant_contact_data	商户联系人信息	JSON	参考下表（商户联系人信息：merchant_contact_data）		M
bankcard_data	结算卡信息	JSON	settlement_symbol=00时必填，参考下表（结算卡信息：bankcard_data）		C
image_data	商户资质图片信息	JSON	参考下表（资质图片信息：image_data）		M
product_data	支付产品信息	JSONARRAY	1.微信、支付宝示例：0.0038 2.云闪付默认按1000元分档，需配小额费率、大额费率 3.刷卡业务，配置小额优惠费率（商户开通小额双免时使用）、标准刷卡费率（非小额双免交易使用）	示例： [{“channel_type”:”WX”,”rate”:”0.0038”},{“channel_type”:”ALI”,”rate”:”0.0038”},{“channel_type”:”UNIONQR”,”rate”:{“underDebitRate”:”0.0020”,”underCreditRate”:”0.0030”,”aboveDebitRate”:”0.0020”,”maxDebitFee”:”25”,”aboveCreditRate”:”0.0060”}},{“channel_type”:”BANK”,”rate”:{“underDebitRate”:”0.0020”,”underCreditRate”:”0.0030”,”DebitRate”:”0.0020”,”maxDebitFee”:”25”,”CreditRate”:”0.0060”}}]	M
settle_data	结算产品信息	JSONARRAY	不填默认使用商户信息，参考下表（结算产品信息：settle_data）		C
notify_url	通知地址	String	商户审核状态变更后的通知地址	http://x.cn/shop/notice	O

商户信息：merchant_data

参数	参数名称	类型	参数说明	样例	可空
ledger_receive_flag	参与分账业务的收账方标识	String	0：否，1：是。如为空，则默认为：0，即为分账方		O
merch_name	商户全称	String	企业、个体工商户，请填写营业执照注册名称，最大50个汉字个体工商户，若营业执照上商户名称为空或为“无”，请填写”个体户+经营者姓名”，如“个体户张三” 小微商户，请填写商户+经营者姓名，如“商户_张三” 事业单位或其他组织，请填写登记证书上的商户名称，如xx公益团体	个体户张三	M
merch_short_name	商户简称	String	最大长度15，门店名称或店铺名称，展示在收银台页	张三餐饮店	M
bus_scope_code	经营范围	String	参考附件：经营范围		M
cert_type	证件类型	String	CERTIFICATE_TYPE_2388：事业单位法人证书 CERTIFICATE_TYPE_2389：统一社会信用代码证书 CERTIFICATE_TYPE_2390：有偿服务许可证（军队医院适用) CERTIFICATE_TYPE_2391：医疗机构执业许可证（军队医院适用) CERTIFICATE_TYPE_2392：企业营业执照（挂靠企业的党组织适用) CERTIFICATE_TYPE_2393：组织机构代码证（政府机关适用) CERTIFICATE_TYPE_2394：社会团体法人登记证书 CERTIFICATE_TYPE_2395：民办非企业单位登记证书 CERTIFICATE_TYPE_2396：基金会法人登记证书 CERTIFICATE_TYPE_2397：慈善组织公开募捐资格证书 CERTIFICATE_TYPE_2398：农民专业合作社法人营业执照 CERTIFICATE_TYPE_2399：宗教活动场所登记证 CERTIFICATE_TYPE_2400：其他证书/批文/证明	CERTIFICATE_TYPE_2389	C
bus_license_no	证件编号	String	企业及个体工商户时上送，填写执照对应的注册号，最大长度 20		O
licence_valid_date	证件有效日期	String	有效期必须大于60天，即结束时间距当前时间需超过60天；示例值：1970-01-01，forever		C
province_code	营业执照经营地址：省代码	String	企业及个体工商户时上送营业执照上的地址事业单位或其他组织，上送证书上的地址小微商户填写实际经营地址，取值详见附录：省市区代码		C
city_code	营业执照经营地址：市代码	String	企业及个体工商户时上送营业执照上的地址事业单位或其他组织，上送证书上的地址小微商户填写实际经营地址，取值详见附录：省市区代码		C
area_code	营业执照经营地址：区代码	String	企业及个体工商户时上送营业执照上的地址事业单位或其他组织，上送证书上的地址小微商户填写实际经营地址，取值详见附录：省市区代码		C
bus_address	营业执照经营地址：详细地址	String	企业及个体工商户时上送，小微商户不填		C
address	实际经营地址：详细地址	String	小微商户必填，实际经营地址，其他商户类型不填则默认与营业执照经营地址相同		C
customer_phone	客服电话	String		不传默认海科客服电话	O

商户法人信息：merchant_corporation_data

参数	参数名称	类型	参数说明	可空
legal_name	法人姓名	String	小微商户上送个人姓名	M
legal_cert_type	法人证件类型	String	1:身份证小微商户上送个人证件类型	M
legal_cert_no	法人证件号	String	小微商户上送个人证件号码	M
identification_valid_date	法人证件有效期	String	示例值：1970-01-01，forever	O

商户联系人信息：merchant_contact_data

参数	参数名称	类型	可空
contact_name	联系人姓名	String	M
contact_phone	联系人手机号	String	M
contact_email	联系人邮箱	String	M

结算卡信息：bankcard_data

参数	参数名称	类型	参数说明	可空
acc_no	结算账户号	String		M
acc_type	结算类型	String	10A：对公 10B：对私	M
acc_name	结算账户名称	String		M
idcard_no	持卡人身份证号	String	acc_type=10B时必传	C
phone	预留手机号	String	acc_type=10B时必传	C
bank_code	开户行联行号	String	附件表：联行号-银行名称-总行标识-省-市-区	M
bank_name	结算卡开户行银行名称	String		O
bank_province_code	开户行网点对应的省代码	String	取值详见附录：省市区代码	O
bank_city_code	开户行网点对应的市代码	String	取值详见附录：省市区代码	O

资质图片信息：image_data

参数	参数名称	类型	参数说明	可空
A1	营业执照图片id	String	小微商户非必传	O
A2	法人身份证正面图片id	String		M
A3	法人身份证反面图片id	String		M
A5	商户门头照图片id	String		M
A6	营业场所室内照图片id	String		M
A4	结算卡正面/开户许可证（基本户）图片id	String	结算卡对私：上传结算卡正面照片结算卡对公：上传开户申请表/开户许可证照片	C
A28	开户许可证（基本户）图片id	String		C
A9999	非法人结算授权函图片id	String	结算卡对私且持卡人身份证号与法人身份证不一致时必传	O
A7	合作协议（首页）图片id	String	连锁门店使用	O
A8	合作协议（业务描述页）图片id	String	连锁门店使用	O
A9	合作协议（盖章页）图片id	String	连锁门店使用	O
A31	营业场所室内照2图片id	String	v(1.32)	M
A32	法人手持结算授权函合影图片id	String		O
A34	营业执照合影（法人/经营者）图片id	String	v(1.32)	O
A35	结算人身份证正面图片id	String	结算卡对私且持卡人身份证号与法人身份证不一致时必传v(1.32)	C
A36	结算人身份证反面图片id	String	结算卡对私且持卡人身份证号与法人身份证不一致时必传v(1.32)	C
A37	中国香港居民-来往内地通行证照片id	String	法人证件选择-中国香港居民-来往内地通行证	C
A38	中国澳门居民-来往内地通行证照片id	String	法人证件选择-中国澳门居民-来往内地通行证	C
A39	中国台湾居民-来往内地通行证照片id	String	法人证件选择-中国台湾居民-来往内地通行证	C
A40	护照照片id	String	法人证件选择-护照	C
A41	事业单位法人证书照片id	String	企事业单位/其他组织选择事业单位法人证书	C
A42	有偿服务许可证（军队医院适用)照片id	String	企事业单位/其他组织选择有偿服务许可证（军队医院适用)	C
A43	医疗机构执业许可证（军队医院适用)照片id	String	企事业单位/其他组织选择医疗机构执业许可证（军队医院适用)	C
A44	企业营业执照（挂靠企业的党组织适用)照片id	String	企事业单位/其他组织选择企业营业执照（挂靠企业的党组织适用)	C
A45	组织机构代码证（政府机关适用)照片id	String	企事业单位/其他组织选择组织机构代码证（政府机关适用)	C
A46	社会团体法人登记证书照片id	String	企事业单位/其他组织选择社会团体法人登记证书	C
A47	民办非企业单位登记证书照片id	String	企事业单位/其他组织选择民办非企业单位登记证书	C
A48	基金会法人登记证书照片id	String	企事业单位/其他组织选择基金会法人登记证书	C
A49	慈善组织公开募捐资格证书照片id	String	企事业单位/其他组织选择慈善组织公开募捐资格证书	C
A50	农民专业合作社法人营业执照照片id	String	企事业单位/其他组织选择农民专业合作社法人营业执照	C
A51	宗教活动场所登记证照片id	String	企事业单位/其他组织选择宗教活动场所登记证	C
A52	统一社会信用代码证书图片id	String	企业/个体/企事业单位/其他组织选择统一社会信用代码证	C
A53	其他证书/批文/证明照片id	String	企事业单位/其他组织选择其他证书/批文/证明	C
A9998	其他	String	v(1.32)	O

支付产品信息：product_data

参数	参数名称	类型	参数说明	样例	可空
channel_type	支付产品类型	String	WX：微信 ALI：支付宝 UNIONQR：云闪付 BANK：银行卡业务		M
rate	费率值	String	参考下表支付宝业务申请信息		M

结算产品信息：settle_data

参数	参数名称	类型	参数说明	可空
settlement_type	结算产品类型	String	D1_AUTO：D1自动结算 T1_AUTO：T1自动结算 D0_AUTO：D0自动结算 Ts_AUTO：Ts笔笔秒到 D1_MANUAL：D1自助提现 D0_MANUAL：D0自助提现	M
settlement_rate_type	计费策略	String	结算产品类型为D0_AUTO，Ts_AUTO，D0_MANUAL时必填 SINGLE_PERCENT:单笔百分比 SINGLE_FIXED:单笔固定值 FIXED_MIX_PERCENT:单笔固定值 + 单笔百分比 PERCENT_MIX_CAP:单笔百分比 + 封顶值	C
d0_riche_time	D0日切时间点	String	1、结算周期为D0时可配置，配置时间点为1-22点整点，不配置默认为22点（例如：D0日切时间点为20点，则20点结算0-20点的交易金额，20点-24点之间交易金额次日进行结算）	O
percentRate	百分比费率值	String	计费策略为 SINGLE_PERCENT、FIXED_MIX_PERCENT、PERCENT_MIX_CAP 时，必填。该字段单位：%；如 0.5%，上传 0.5 即可。不传默认为0	C
fixedRate	固定费率值/封顶值	String	计费策略为 SINGLE_FIXED、FIXED_MIX_PERCENT、PERCENT_MIX_CAP 时，必填；单位为：元，比如费率为 1元/笔, 需要传 1 。不传默认为0	C

请求示例:

返回参数说明:

参数	参数名称	类型	参数说明	样例	可空
return_code	返回码	String	10000		M
return_msg	返回信息	JSON	银行卡申请成功		M
agent_no	服务商编号	String	服务商的编号，由SAAS平台分配，表示当前商户属于该服务商名下	88888888	M
agent_apply_no	服务商申请单号	String	服务商申请单号		M
merch_no	商户编号	String	一级商户编号，适用于总店场景		M
store_id	门店编号	String	由海科SaaS平台分配的门店编号，门店编号是商户编号的二级编号		M

返回示例:

附件

省市区编码.xlsx

文档更新时间: 2021-06-17 17:32 作者：王金晶