请求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-08-02 17:34   作者:王金晶