概要描述:
该接口适用于原商户入网申请单状态为:自动审核通过、审核中、审核通过状态下可调用该接口进行修改
请求URL:
- 测试环境:
请求参数(O-非必传 ,C-条件必传 ,M-必传):
参数 | 参数名称 | 类型 | 参数说明 | 样例 | 可空 |
---|---|---|---|---|---|
agent_no | 服务商编号 | String | M | ||
agent_apply_no | 服务商申请流水号 | String | 服务商系统生成 | M | |
store_id | 门店编号 | String | 由海科SaaS平台分配的门店编号,门店编号是商户编号的二级编号 | M | |
merchant_data | 商户主体信息 | Json | 参考下表(商户信息:merchant_data_) | O | |
merchant_corporation_data | 商户法人信息 | Json | 参考下表(商户法人信息:merchant_corporation_data) | O | |
merchant_contact_data | 商户联系人信息 | Json | 参考下表(商户联系人信息:merchant_contact_data) | O | |
image_data | 商户资质图片信息 | Json | O |
商户主体信息 merchant_data
参数 | 参数名称 | 类型 | 参数说明 | 样例 | 可空 |
---|---|---|---|---|---|
merch_name | 商户全称 | String | 企业、个体工商户,请填写营业执照注册名称,最大50个汉字;个体工商户,若营业执照上商户名称为空或为“无”,请填写”个体户+经营者姓名”,如“个体户张三”;小微商户,请填写商户+经营者姓名,如“商户_张三”;事业单位或其他组织,请填写登记证书上的商户名称,如xx公益团体 | 个体户张三 | O |
merch_short_name | 商户简称 | String | 最大长度15,门店名称或店铺名称,展示在收银台页 | 张三餐饮店 | O |
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 | O |
licence_valid_date | 证件有效日期 | String | 有效期必须大于60天,即结束时间距当前时间需超过60天;示例值:["1970-01-01","forever"] | O | |
bus_province_code | 营业执照经营地址:省代码 | String | 企业及个体工商户时上送营业执照上的地址 事业单位或其他组织,上送证书上的地址 小微商户填写实际经营地址,取值详见附录:省市区代码 |
O | |
bus_city_code | 营业执照经营地址:市代码 | String | 企业及个体工商户时上送营业执照上的地址 事业单位或其他组织,上送证书上的地址 小微商户填写实际经营地址,取值详见附录:省市区代码 |
O | |
bus_area_code | 营业执照经营地址:区代码 | String | 企业及个体工商户时上送营业执照上的地址 事业单位或其他组织,上送证书上的地址 小微商户填写实际经营地址,取值详见附录:省市区代码 |
O | |
bus_address | 营业执照经营地址:详细地址 | String | 企业及个体工商户时上送,小微商户不填 | O | |
address | 实际经营地址:详细地址 | String | 小微商户必填,实际经营地址,其他商户类型不填则默认与营业执照经营地址相同 | O | |
customer_phone | 客服电话 | String | 不传默认海科客服电话 | O |
商户法人信息:merchant_corporation_data
参数 | 参数名称 | 类型 | 参数说明 | 样例 | 可空 |
---|---|---|---|---|---|
legal_name | 法人姓名 | String | 小微商户上送个人姓名 | O | |
legal_cert_type | 法人证件类型 | String | 1:身份证 小微商户上送个人证件类型 |
O | |
legal_cert_no | 法人证件号 | String | 小微商户上送个人证件号码 | O | |
identification_valid_date | 法人证件有效期 | String | 示例值:["1970-01-01","forever"] | O |
商户联系人信息:merchant_contact_data
参数 | 参数名称 | 类型 | 参数说明 | 样例 | 可空 |
---|---|---|---|---|---|
contact_name | 联系人姓名 | String | O | ||
contact_email | 联系人邮箱 | String | O |
资质图片信息:image_data
参数 | 参数名称 | 类型 | 参数说明 | 样例 | 可空 |
---|---|---|---|---|---|
A1 | 营业执照图片id | String | 小微商户非必传 | O | |
A2 | 法人身份证正面图片id | String | O | ||
A3 | 法人身份证反面图片id | String | O | ||
A5 | 商户门头照图片id | String | O | ||
A6 | 营业场所室内照图片id | String | O | ||
A7 | 合作协议(首页)图片id | String | 连锁门店使用 | O | |
A8 | 合作协议(业务描述页)图片id | String | 连锁门店使用 | O | |
A9 | 合作协议(盖章页)图片id | String | 连锁门店使用 | O | |
A31 | 营业场所室内照2图片id | String | v(1.32) | O | |
A34 | 营业执照合影(法人/经营者)图片id | String | v(1.32) | O | |
A9998 | 其他 | String | v(1.32) | O |
返回参数说明:
参数 | 参数名称 | 类型 | 参数说明 | 样例 | 可空 |
---|---|---|---|---|---|
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 | |
merch_status | 审核状态 | String | 1:自动审核通过(已获得交易权限) 2:审核中 (提前获取交易权限,事后人工抽检) 3:审核拒绝 4:审核通过 |
M | |
status_msg | 审核描述 | String | 人工审核时输入的文字描述 | O |
文档更新时间: 2021-03-19 10:16 作者:王金晶