简要描述：

请求URL:

请求参数(O-非必传 ,M-必传)

参数 参数名称 类型 参数说明 样例 可空
agent_no 服务商编号 String 服务商的编号，由SAAS平台分配，表示当前商户属于该服务商名下 88888888 M
agent_apply_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
agent_rate_formwork_id 活动模板id String 活动模板id，用于服务商通过海科创建的活动模板，为商户做优惠费率活动补贴；不用此功能可为空 O
商户信息：merchant_data
参数 参数名称 类型 参数说明 样例 可空
big_merch_no 大商户编号 String (v1.12)如果不填大商户号默认入网返回是大商户，如果填写返回该大商户下小商户 O
ledger_receive_flag 分账业务标识 String 0：分账业务中为分账方（未开通分账业务为交易商户）
1：分账业务中为收账方
非必填，为空默认为0 (v1.18)		 O
merch_type 商户类型 String 10A:个体工商户
10B:企业
10C:小微商户
10D:事业单位
10E:政府机构
10F:社会组织		 10A M
merch_name 商户全称 String 企业及个体工商户时上送，最大长度40 中国大餐厅 O
merch_short_name 商户简称 String 最大长度15(v1.07) 中餐厅 M
shop_name 门店名称 String 商户门头名称 中国大餐厅西直门店 M
merchant_cert_type 经营许可证件类型 String 商10A\10B默认0,10E\10F默认为1,10D默认为2
0、营业执照（10A\10B可选）
1、统一社会信用代码证（10E\10F可选）
2、事业单位法人证书（10D可选）
3、社会团体法人登记证书（10F可选）
4、民办非企业单位登记证书（10F可选）
5、基金会法人登记证书（10F可选）
6、宗教活动场所登记证（10F可选）
7、政府部门下发的其他有效证明文件（10F可选）
8、执业许可证/执业证（10F可选）
9、基层群众性自治组织特别法人统一社会信用代码证（10F可选）
10、农村集体经济组织登记证（10F可选）		 O
bus_license_no 执照号 String ，企业及\体工商户\事业单位\政府机构\社会组织时上送，最大长度 20 O
bus_license_start 营业执照号开始时间 String 格式yyyy-MM-dd M
bus_license_end 营业执照号结束时间 String 1、格式yyyy-MM-dd ，如果是长期则传 9999-12-31 ；结束时间需要大于开始时间
2、填写营业执照号开始时间结束时间必须填写营业执照号开始时间开始时间		 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:中国台湾居民-来往大陆通行证
10：外国人永久居留身份证
11：港澳居民居住证
12：台湾居民居住证
13：执行事务合伙人
其中2、3、4、5、10、11、12、支持对公和对私法人结算，不允许入网小微商户其中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 O
service_phone 客服电话 String 不支持输入-或者+，示例：075586010000 O
bus_scope_code 营业范围代码 String 取值详见附录：营业范围 M
结算卡信息：bankcard_data
参数 参数名称 类型 参数说明 样例 可空
acc_no 结算账户号 String M
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
bank_name 结算卡开户银行网点名称 String acc_type=10A时必传(v1.08) O
bank_province_code 开户行网点 对应的省代码 String 取值详见附录：省市区代码 M
bank_city_code 开户行网点 对应的市代码 String 取值详见附录：省市区代码 M
资质图片信息：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 结算卡对私：上传结算卡正面照片
结算卡对公：上传开户申请表/开户许可证照片		 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图片id String v(1.32) M
A32 法人手持结算授权函合影图片id String 结算卡对私且持卡人身份证号与法人身份证不一致时必传v(1.32) O
A34 营业执照合影（法人/经营者）图片id String v(1.32) O
A35 结算人身份证正面图片id String 结算卡对私且持卡人身份证号与法人身份证不一致时必传v(1.32) O
A36 结算人身份证反面图片id String 结算卡对私且持卡人身份证号与法人身份证不一致时必传v(1.32) O
A9998 其他 String v(1.32) O

请求示例:

{
    "agent_no": "11010200097",
    "agent_apply_no": "950559944959",
    "notify_url": "https://www.baidu.com",
    "merchant_data": {
        "big_merch_no": "",
        "contact_name": "测试联系人姓名",
        "address": "北京市海淀区西直门金运大厦A座11楼",
        "legal_cert_type": "1",
        "contact_phone": "12312341234",
        "area_code": "110101",
        "merch_type": "10A",
        "city_code": "110100",
        "province_code": "110000",
        "shop_name": "门店名称1",
        "bus_area_code": "110101",
        "contact_email": "saas@hkrt.cn",
        "merch_name": "商户名称1",
        "ledger_receive_flag": "0",
        "legal_cert_no": "231182111111117717",
        "bus_address": "北京市海淀区西直门金运大厦A座11楼",
        "merch_short_name": "商户简称1",
        "bus_license_no": "111222333444555",
        "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": "12312345678",
        "acc_no": "6217000010044116492",
        "bank_name": "西直门支行",
        "bank_city_code": "110100",
        "idcard_no": "231182123412341234",
        "bank_province_code": "110000"
    },
    "image_data": {
        "A32": "",
        "A34": "",
        "A35": "",
        "A36": "",
        "A28": "c0941d8a969b4e20a890be8f6edc2959",
        "A9998": "",
        "A9999": "c0941d8a969b4e20a890be8f6edc2959",
        "A1": "c0941d8a969b4e20a890be8f6edc2959",
        "A2": "c0941d8a969b4e20a890be8f6edc2959",
        "A3": "c0941d8a969b4e20a890be8f6edc2959",
        "A4": "c0941d8a969b4e20a890be8f6edc2959",
        "A5": "c0941d8a969b4e20a890be8f6edc2959",
        "A6": "c0941d8a969b4e20a890be8f6edc2959",
        "A7": "c0941d8a969b4e20a890be8f6edc2959",
        "A8": "c0941d8a969b4e20a890be8f6edc2959",
        "A9": "c0941d8a969b4e20a890be8f6edc2959",
        "A31": ""
    },
    "accessid": "cpostest",
    "sign": "96B6AB9A8D9617BABD0B461668BBE711"
}

返回参数说明:

参数 参数名称 类型 参数说明 样例 可空
merch_no SAAS平台商户编号 String 11001088888888 M

返回示例:

正确：
{
    "merch_no": "11010100002012",
    "return_code": 10000,    
    "sign": "E404975210F262C53AEA532C6A790E14"
}
错误：
{
    "return_code": 22027,
    "return_msg": "营业场所室内照2照片未上传正确"
}
附件
文档更新时间: 2024-08-02 17:36   作者：王金晶