概要描述:
该接口适用于原商户入网申请单状态为:自动审核通过、审核中、审核通过状态下可调用该接口进行修改
请求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 作者:王金晶