请求URL:
请求参数(O-非必传 ,M-必传)
参数 | 参数名称 | 类型 | 参数说明 | 样例 | 可空 |
---|---|---|---|---|---|
agent_no | 服务商编号 | String | 服务商的编号,由SaaS平台分配,表示当前商户属于该服务商名下 | 88888888 | M |
merch_no | 商户编号 | String | 商户编号 | M | |
merchant_data | 商户信息 | JSON | 参考下表(商户信息:merchant_data) | M | |
bankcard_data | 结算卡信息 | JSON | 参考下表(结算卡信息:bankcard_data) | M | |
image_data | 商户资质图片信息 | JSON | 参考下表(资质图片信息:image_data) | M | |
notify_url | 通知地址 | String | 商户审核状态变更后的通知地址 | http://x.cn/shop/notice | O |
商户信息:merchant_data
参数 | 参数名称 | 类型 | 参数说明 | 样例 | 可空 |
---|---|---|---|---|---|
big_merch_no | 大商户编号 | String | (v1.12)这里是修改上边merch_no如果是小商户的话,改变该小商户的大商户号 | O | |
ledger_receive_flag | 分账收账方标识 | String | 0:否,1:是,为空默认为:0(v1.18) | O | |
merch_type | 商户类型 | String | 10A:个体工商户 10B:企业 10C:小微商户 |
10A | M |
merch_name | 商户全称 | String | 企业及个体工商户时上送,最大长度40 | 中国大餐厅 | O |
merch_short_name | 商户简称 | String | 最大长度15(v1.07) | 中餐厅 | M |
shop_name | 门店名称 | String | 商户门头名称 | 中国大餐厅西直门店 | M |
bus_license_no | 营业执照号 | String | 企业及个体工商户时上送,最大长度 20 | O | |
bus_license_start | 营业执照号开始时间 | String | 格式yyyy-MM-dd | M | |
bus_license_end | 营业执照号结束时间 | String | 格式yyyy-MM-dd ,如果是长期则传 9999-12-31 ;结束时间需要大于开始时间 | M | |
bus_province_code | 营业执照经营地址:省代码 | String | 企业及个体工商户时上送,取值详见附录:省市区代码 | O | |
bus_city_code | 营业执照经营地址:市代码 | String | 企业及个体工商户时上送,取值详见附录:省市区代码 | O | |
bus_area_code | 营业执照经营地址:区代码 | String | 企业及个体工商户时上送,取值详见附录:省市区代码 | O | |
bus_address | 营业执照经营地址:详细地址 | String | 企业及个体工商户时上送 | O | |
province_code | 实际经营地址:省代码 | String | 取值详见附录:省市区代码 | M | |
city_code | 实际经营地址:市代码 | String | 取值详见附录:省市区代码 | M | |
area_code | 实际经营地址:区代码 | String | 取值详见附录:省市区代码 | M | |
address | 实际经营地址:详细地址 | String | M | ||
legal_name | 法人姓名 | String | 小微商户上送个人姓名 | M | |
legal_cert_type | 法人证件类型 | String | 1:身份证(小微商户上送个人证件类型) 2、中国香港居民-来往内地通行证 3、为其他国家或地区居民-护照 4、中国澳门居民-来往内地通行证 5、中国台湾居民-来往大陆通行证 其中2、3、4、5支持对公和对私法人结算,不允许入网小微商户 |
M | |
legal_cert_no | 法人证件号 | String | 小微商户上送个人证件号码 | M | |
legal_cert_start | 法人证件开始时间 | String | 身份证有效期开始时间 | M | |
legal_cert_end | 法人证件结束时间 | String | 身份证有效期结束时间 1、请填写法人证件的有效时间,注意参照示例中的格式,如果为永久则不传。 2、结束时间需大于开始时间。 3、证件有效期需大于60天,即结束时间距当前时间需超过60天。 示例值:[“1970-01-01”,”1980-01-01“] 4、填写法人证件结束时间必须填写法人证件开始时间 |
O | |
contact_name | 联系人姓名 | String | M | ||
contact_phone | 联系人手机号 | String | M | ||
contact_email | 联系人邮箱 | String | M | ||
service_phone | 客服电话 | String | 不支持输入-或者+,示例:075586010000 | O | |
bus_scope_code | 营业范围代码 | String | 取值详见附录:营业范围 | M |
结算卡信息:bankcard_data
参数 | 参数名称 | 类型 | 参数说明 | 样例 | 可空 |
---|---|---|---|---|---|
acc_type | 结算类型 | String | 10A:对公 10B:对私 |
M | |
acc_name | 结算账户名称 | String | M | ||
idcard_no | 持卡人身份证号 | String | acc_type=10B时必传 | O | |
phone | 预留手机号 | String | acc_type=10B时必传 | O | |
bank_code | 结算账户清算行号 | String | 取值详见附录: 银行列表 | M | |
acc_no | 结算账户号 | String | M | ||
bank_name | 结算卡开户银行网点名称 | String | acc_type=10A时必传(v1.08) | O | |
bank_province_code | 开户行网点 对应的省代码 | String | 取值详见附录:省市区代码 | M | |
bank_city_code | 开户行网点 对应的市代码 | String | 取值详见附录:省市区代码 | M |
资质图片信息:image_data
参数 | 参数名称 | 类型 | 参数说明 | 样例 | 可空 |
---|---|---|---|---|---|
A1 | 营业执照图片id | String | M | ||
A2 | 法人身份证正面图片id | String | M | ||
A3 | 法人身份证反面图片id | String | M | ||
A5 | 商户门头照图片id | String | M | ||
A6 | 营业场所室内照图片id | String | M | ||
A4 | 结算卡正面/开户许可证(基本户)图片id | String | 结算卡对私:上传结算卡正面照片 结算卡对公:上传开户申请表/开户许可证照片 |
M | |
A28 | 开户许可证(基本户)图片id | String | O | ||
A9999 | 非法人结算授权函图片id | String | 结算卡对私且持卡人身份证号与法人身份证不一致时必传 | O | |
A7 | 合作协议(首页)图片id | String | 小商户时必传(v1.12) | O | |
A8 | 合作协议(业务描述页)图片id | String | (v1.13) | O | |
A9 | 合作协议(盖章页)图片id | String | 小商户时必传(v1.12) | O | |
A31 | 营业场所室内照2 | String | v(1.32) | M | |
A32 | 法人手持结算授权函合影照片 | String | 结算卡对私且持卡人身份证号与法人身份证不一致时必传v(1.32) | O | |
A34 | 营业执照合影(法人/经营者) | String | v(1.32) | O | |
A35 | 结算人身份证正面 | String | 结算卡对私且持卡人身份证号与法人身份证不一致时必传v(1.32) | O | |
A36 | 结算人身份证反面 | String | 结算卡对私且持卡人身份证号与法人身份证不一致时必传v(1.32) | O | |
A9998 | 其他 | String | v(1.32) | O |
请求示例:
{
"agent_no": "11010200097",
"merch_no": "833581758120002",
"agent_apply_no": "553697699204",
"notify_url": "https://www.baidu.com",
"merchant_data": {
"big_merch_no": "",
"contact_name": "张三",
"address": "北京市海淀区西直门金运大厦A座11楼",
"legal_cert_type": "1",
"contact_phone": "12312345678",
"area_code": "110101",
"merch_type": "10A",
"city_code": "110100",
"province_code": "110000",
"shop_name": "测试部境内大商户",
"bus_area_code": "110101",
"contact_email": "saas@hkrt.cn",
"merch_name": "测试部境内大商户",
"ledger_receive_flag": "0",
"legal_cert_no": "231182123456788303",
"bus_address": "北京市海淀区西直门金运大厦A座11楼",
"merch_short_name": "人民币大商户",
"bus_license_no": "91440300MA5FF5XEXC22",
"legal_name": "张三",
"bus_city_code": "110100",
"bus_province_code": "110000",
"bus_scope_code": "00010007"
},
"bankcard_data": {
"acc_name": "张三",
"bank_code": "105100000017",
"acc_type": "10A",
"phone": "18645178182",
"acc_no": "111101",
"bank_name": "西直门支行",
"bank_city_code": "110100",
"idcard_no": "231182111111118303",
"bank_province_code": "110000"
},
"image_data": {
"A32": "6ea605328e93413190cac49dd7965e59",
"A34": "6ea605328e93413190cac49dd7965e59",
"A35": "6ea605328e93413190cac49dd7965e59",
"A36": "6ea605328e93413190cac49dd7965e59",
"A28": "6ea605328e93413190cac49dd7965e59",
"A9998": "",
"A9999": "6ea605328e93413190cac49dd7965e59",
"A1": "6ea605328e93413190cac49dd7965e59",
"A2": "6ea605328e93413190cac49dd7965e59",
"A3": "6ea605328e93413190cac49dd7965e59",
"A4": "6ea605328e93413190cac49dd7965e59",
"A5": "6ea605328e93413190cac49dd7965e59",
"A6": "6ea605328e93413190cac49dd7965e59",
"A7": "6ea605328e93413190cac49dd7965e59",
"A8": "6ea605328e93413190cac49dd7965e59",
"A9": "6ea605328e93413190cac49dd7965e59",
"A31": "6ea605328e93413190cac49dd7965e59"
},
"accessid": "cpostest",
"sign": "793F54D0E4B8E2D073BB76610003A5B0"
}
返回参数说明:
参数 | 参数名称 | 类型 | 参数说明 | 样例 | 可空 |
---|---|---|---|---|---|
merch_no | SAAS平台商户编号 | String | 11001088888888 | M |
返回示例:
正确:
{
"merch_no": "833581758120002",
"return_code": 10000,
"sign": "F07B3E86B0502C96C5393F8C0B97322A"
}
错误:
{
"return_code": 22004,
"return_msg": "营业执照照片为空"
}
文档更新时间: 2024-10-11 16:07 作者:王金晶