新增总部¶
服务商通过此接口在汇付创建连锁商户总部。
请求参数¶
- 请求地址
https://spin.cloudpnr.com/ssproxy/addChainsCorpInfo
- 公共请求参数
请求报文头HEADER - 「接口规则-参数规定-报文头」 ，请求报文体BODY - 「接口规则-参数规定-报文体」 ，响应报文体 - 「接口规则-参数规定-响应报文体」
- 请求参数(data)
| 参数 | 中文名 | 类型 | 必填 | 最大长度 | 说明 |
|---|---|---|---|---|---|
| req_seq_id | 请求流水号 | String | Y | 32 | 请求流水号 |
| req_date | 请求时间 | String | Y | 32 | 请求时间YYYYMMDD |
| huifu_id | 渠道商汇付Id | String | Y | 18 | 汇付分配的渠道商号 |
| product_id | 产品编号 | String | Y | 32 | 固定值产品编号 |
| name | 总部名称 | String | Y | 32 | 渠道商下总部名称不能重复 |
| contact_name | 联系人姓名 | String | Y | 32 | |
| contact_mobile_no | 联系人手机号 | String | Y | 64 | |
| contact_cert_no | 联系人身份证号码 | String | Y | 11 | |
| login_name | 管理员账号 | String | C | 32 | 有值，必须全网唯一；为空，不生成管理员账号 |
| login_mobile_no | 管理员手机号 | String | C | 32 | 有值生成APP登录手机号 |
| add_corp_info | 企业信息 | Object | N | 11 | JSON对象 |
| bd_login_user_id | 业务经理userId | String | N | 20 | |
| mer_huifu_id | 商户汇付Id | String | N | 18 | 绑定总部商户汇付Id |
add_corp_info(企业信息)
| 参数 | 中文名 | 类型 | 必填 | 最大长度 | 说明 |
|---|---|---|---|---|---|
| reg_name | 企业客户注册名称 | String | Y | 64 | |
| license_code | 营业执照编号 | String | Y | 18 | |
| license_validity_type | 营业执照有效期类型 | String | Y | 1 | 1:长期有效 0:非长期有效 |
| license_begin_date | 营业执照有效期开始日期 | String | Y | 8 | |
| license_end_date | 营业执照有效期截止日期 | String | C | 8 | 营业执照有效期类型非长期有效时必填 |
| mcc | 所属行业（MCC） | String | Y | 4 | 银联MCC编码 |
| reg_prov_id | 注册省 | String | Y | 6 | 六位地区码 |
| reg_area_id | 注册市 | String | Y | 8 | 六位地区码 |
| reg_district_id | 注册区 | String | Y | 12 | 六位地区码 |
| reg_detail | 注册详细地址 | String | Y | 256 | |
| legal_name | 法人姓名 | String | Y | 32 | |
| legal_cert_type | 法人证件类型 | String | Y | 2 | 00:身份证 01:护照 02:军官证 03:士兵证 04:回乡证 05:户口本 06:外国护照 07:其他 08:暂住证 09:警官证 10:文职干部证 11:港澳同胞回乡证 |
| legal_cert_no | 法人证件号码 | String | Y | 32 | |
| legal_cert_validity_type | 法人证件有效期类型 | String | Y | 1 | 1:长期有效 0:非长期有效 |
| legal_cert_begin_date | 法人证件有效期开始日期 | String | Y | 8 | |
| legal_cert_end_date | 法人证件有效期截止日期 | String | C | 8 | 法人证件有效期类型为长期有效时可不填 |
| legal_mobile_no | 法人手机号 | String | Y | 11 | |
| allow_mer_use_chains_flag | 是否允许商户使用总部资质 | String | Y | 1 | Y是 N否 |
| file_list | 文件列表 | List | N | 附件资料列表fileList | |
| category_one | 行业一级分类 | String | N | 16 | |
| category_two | 行业二级分类 | String | N | 16 |
file_list(文件列表)
| 参数 | 中文名 | 类型 | 必填 | 最大长度 | 说明 |
|---|---|---|---|---|---|
| file_type | 文件类型 | String | Y | 8 | |
| file_id | 文件jfileID | String | Y | 128 | 调用图片上传传接口获取的图片文件ID |
| file_name | 文件名称 | String | N | 64 |
响应参数¶
- 同步响应参数(data)
| 参数 | 中文名 | 类型 | 必填 | 最大长度 | 说明 |
|---|---|---|---|---|---|
| resp_code | 业务返回码 | String | Y | 5 | 业务返回码 |
| resp_desc | 业务返回描述 | String | Y | 512 | 网关返回描述 |
| sign | 签名 | String | Y | 签名，对报文整体签名 | |
| data | 交易响应内容体 | String | N | 返回参数 |
- 异步响应参数(data)
| 参数 | 中文名 | 类型 | 必填 | 最大长度 | 说明 |
|---|---|---|---|---|---|
| sub_resp_code | 业务返回码 | String | Y | 8 | 业务返回码 |
| sub_resp_desc | 业务返回描述 | String | Y | 512 | 业务返回描述 |
| chains_id | 连锁编号 | String | Y | 8 |
请求示例¶
{
"data":"{\"bd_login_user_id\":\"\",\"contact_name\":\"联系人姓名\",\"login_mobile_no\":\"\",\"req_sys_id\":\"TOP\",\"contact_cert_no\":\"110101200208179198\",\"login_name\":\"\",\"req_seq_id\":\"rQ202106299310040458842\",\"req_date\":\"20210629\",\"product_id\":\"ZDTEST\",\"name\":\"2021062905360911\",\"contact_mobile_no\":\"*\",\"huifu_id\":\"6666000103398186\",\"mer_huifu_id\":\"6666000103147131\"}",
"sys_id":"ssproxy_dev",
"sign":"kTumtM5IlKwAi262tU+G0yQUE9UgNxviT1iPvcHf2O4aPmw6/lHN3Wg6ZO0FxA9d8kgGc075R4u4a1kVAUB3ypVZmD3pcDhxeqDGhi15Jv5n3HHOKk6wIdwGz2B66l/mekGqh3ak6s83naG7RPO2MUfzSVMTNld7LhSlsqcbQ6o=",
"sign_type":"RSA2"
}
响应示例¶
{"data":"{\"sub_resp_code\":\"00000000\",\"chains_id\":\"10006559\",\"sub_resp_desc\":\"成功\"}","resp_desc":"成功调用","resp_code":"10000","sign":"KAhfyMx+hJ2266isMKL4oxvfnObnUbeU9fEVZ1AW14Rf3BNCm6cRreLSN33tbsoB9rUgl0iUCAc+GXSEglE29lT+5lL+R4T0CBFEhv8pDjXrDmymL3ew+aMHxfch4l6zJ6c/Z5TPoGQMVsdRpXjkGojTdMMHoYQ02rNAV0/Xi8A="}
