简要描述：

  • 本接口用于聚合完成商户入网、产品开通、业务报备；商户入网及产品开通同步处理，业务报备异步处理；

  • 商户信息通过相关认证及鉴权后，同步返回商户编号；

  • 商户入网审核状态和各业务报备状态，通过商户信息查询接口获得；

  • 商户入网成功后，结算产品信息为空或结算信息传入参数不合法时，商户结算产品会默认配置为对公结算为T1，对私结算为D1；

  • 商户入网成功（商户状态为：待审核或者自动审核）且支付产品业务报备失败或结算产品开通不符时，可调用此接口，变更申请单号（服务商申请单号保证唯一），上送merch_no商户编号进行修改再次提交，海科继续完成业务报备和修改流程；

  • 商户入网同步响应若出现超时，使用服务商申请单号调用“商户状态及业务开通查询”接口查询入网及报备结果；

请求URL:

请求参数( O-非必传，M-必传，C-条件选填):

参数 参数名称 类型 参数说明 样例 可空
agent_no 服务商编号 String 服务商的编号，由SAAS平台分配，表示当前商户属于该服务商名下 isv001888/FW2008888 M
agent_apply_no 服务商申请单号 String 服务商系统生成的请求流水号，保证唯一 M
merch_no 商户编号 String 启用修改功能时传递 C
merchant_data 商户信息 JSON 参考下表（商户信息：merchant_data） M
bankcard_data 结算卡信息 JSON 参考下表（结算卡信息：bankcard_data） M
image_data 商户资质图片信息 JSON 参考下表（资质图片信息：image_data） M
product_data 支付产品信息 JSON 参考下表（支付产品信息：product_data） M
settle_data 结算产品信息 JSON 字段为空时为默认结算方式;参考下表（支付结算信息：settle_data） O
notify_url 通知地址 String 商户审核状态变更后的通知地址 http://x.cn/shop/notice O
agent_rate_formwork_id 活动模板id String 活动模板id，用于服务商通过海科创建的活动模板，为商户做优惠费率活动补贴；不用此功能可为空 O
商户信息：merchant_data
参数 参数名称 类型 参数说明 样例 可空
big_merch_no 大商户编号 String 连锁门店使用，如果不填大商户号默认入网返回是大商户，如果填写返回该大商户下小商户
未与商务沟通前，该参数不用填写		 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 企业及个体工商户时上送 北京市北京市海淀区西直门金运大厦A座 O
province_code 实际经营地址：省代码 String 取值详见附录：省市区代码 M
city_code 实际经营地址：市代码 String 取值详见附录：省市区代码 M
area_code 实际经营地址：区代码 String 取值详见附录：省市区代码 ) M
address 实际经营地址：详细地址 String 北京市-北京市-海淀区-西直门金运大厦A座 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、支持对公和对私法人结算，不允许入网小微商户		 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
支付产品信息：product_data
参数 参数名称 类型 参数说明 样例 可空
wx 微信业务申请信息 JSON 参看下表微信业务申请信息 O
ali 支付宝业务申请信息 JSON 参考下表支付宝业务申请信息 O
bank 银行卡/银联二维码业务申请信息 JSON 参考下表银行卡/银联二维码业务申请信息 O
微信业务申请信息：wx
参数 参数名称 类型 参数说明 样例 可空
channel_no 微信渠道号 String 服务商通过海科申请的微信渠道号 M
settle_id 结算规则id String 原微信行业类目，非必填参数
取值详见附录：微信经营类目（新）		 O
rate 费率值 String 单位为万分之一，例如费率为0.6%,需要传60。（如果为0.2，需要传20） 20 M
支付宝业务申请信息：ali
参数 参数名称 类型 参数说明 样例 可空
channel_no 支付宝渠道号 String 服务商自行申请的支付宝渠道号(v1.13) M
business_id 经营类目id String 非必填参数
取值详见附录：支付宝商户经营类目		 O
mcc 支付宝mcc String 非必填参数
取值详见附录：支付宝MCC和经营类目		 O
rate 费率值 String 单位为万分之一，例如费率为0.6%,需要传60。（如果为0.2，需要传20） 20 M
银行卡/银联二维码业务申请信息：bank（银行卡和银联二维码需要同时上传）
参数 参数名称 类型 参数说明 样例 可空
bank_debit_rate 银行卡借记卡费率 String 不使用银行卡可不填；例如费率为0.6,需要传60; O
bank_debit_max 银行卡借记卡手续费封顶 String 不使用银行卡可不填；18元需要传1800 O
bank_credit_rate 银行卡贷记卡费率 String 不使用银行卡可不填；例如费率为0.6,需要传60; O
union_debit_rate 银联二维码借记卡费率 String 不适用例如费率为0.6,需要传60; O
union_debit_max 银联二维码借记卡手续费封顶 String 18元需要传1800 O
union_credit_rate 银联二维码贷记卡费率 String 例如费率为0.6,需要传60; O
union_mix_rate 银联二维码1000以下包括1000费率值 String 例如费率为0.6,需要传60; O
结算产品信息：settle_data
参数 参数名称 类型 参数说明 样例 可空
settlement_cycle 结算周期 String T1(工作日自动结算)
D1(每日自动结算)
D0(定时自动结算，2笔到账)
D24(自定义日切结算一笔到账)
Ts（笔笔秒到，需要单独申请）		 M
d0_riche_time D0日切时间点 String 1、结算周期为D0时可配置，配置时间点为7-23点整点，不配置默认为22点（例如：D0日切时间点为20点，20点结算0点-20点周期内的交易金额，20点-24点之间交易金额于次日进行第二笔结算） O
d24_point_contact D24 日切时间点 String 自定义日切时间点，7-23点整点；配置后一笔到账，如18-18点 O
withdrawal_rate 提现费率 String 单位为：%，比如费率为 0.6%, 需要传 0.6。注：settlement_cycle字段为T1时必须为0 M
withdrawal_feemin 单笔最低提现手续费 String 单位为：元，比如费率为 1, 需要传 1 。注：settlement_cycle字段为T1时必须为0 M
public_withdrawal_rate 对公费率 String 单位为：%，比如费率为 0.6%, 需要传 0.6 。注：settlement_cycle字段为T1时必须为0,结算卡为对公时必传 C
public_withdrawal_feemin 对公单笔最低手续费 String 单位为：元，比如费率为 1, 需要传 1 。注：settlement_cycle字段为T1时必须为0,结算卡为对公时必传 C

请求示例:

{
    "agent_no": "11010200097",
    "agent_apply_no": "927412858902fe1",
    "notify_url": "https://www.baidu.com",
    "merchant_data": {
        "legal_cert_end": "2030-08-08",
        "contact_phone": "12312345678",
        "merch_type": "10A",
        "city_code": "110100",
        "province_code": "110000",
        "contact_email": "saas@hkrt.cn",
        "merch_short_name": "商户简称1",
        "legal_name": "张三",
        "bus_city_code": "110100",
        "bus_scope_code": "00010007",
        "contact_name": "张三",
        "address": "北京市海淀区西直门金运大厦A座11楼",
        "legal_cert_type": "1",
        "area_code": "110101",
        "shop_name": "门店名称1",
        "bus_area_code": "110101",
        "merch_name": "商户名称1",
        "ledger_receive_flag": "",
        "legal_cert_no": "231182123412341234",
        "bus_address": "北京市海淀区西直门金运大厦A座11楼",
        "bus_license_no": "111222333444dsf13",
        "bus_province_code": "110000",
        "legal_cert_start": "2020-08-08"
    },
    "bankcard_data": {
        "acc_name": "12312345678",
        "bank_code": "105100000017",
        "acc_type": "10B",
        "phone": "12312345678",
        "acc_no": "6217000010044116492",
        "bank_name": "西直门支行",
        "bank_city_code": "110100",
        "idcard_no": "231182123412341234",
        "bank_province_code": "110000"
    },
    "image_data": {
        "A32": "77cf1a60f951405bb357417057f80750",
        "A34": "77cf1a60f951405bb357417057f80750",
        "A35": "77cf1a60f951405bb357417057f80750",
        "A36": "77cf1a60f951405bb357417057f80750",
        "A28": "77cf1a60f951405bb357417057f80750",
        "A9998": "77cf1a60f951405bb357417057f80750",
        "A9999": "77cf1a60f951405bb357417057f80750",
        "A1": "77cf1a60f951405bb357417057f80750",
        "A2": "77cf1a60f951405bb357417057f80750",
        "A3": "77cf1a60f951405bb357417057f80750",
        "A4": "77cf1a60f951405bb357417057f80750",
        "A5": "77cf1a60f951405bb357417057f80750",
        "A6": "77cf1a60f951405bb357417057f80750",
        "A7": "77cf1a60f951405bb357417057f80750",
        "A8": "77cf1a60f951405bb357417057f80750",
        "A9": "77cf1a60f951405bb357417057f80750",
        "A31": "77cf1a60f951405bb357417057f80750"
    },
    "product_data": {
        "wx": {
            "rate": "38",
            "channel_no": "222970902d",
            "mcc": "",
            "settle_id": "770"
        },
        "bank": {
            "bank_debit_rate": "38",
            "bank_credit_rate": "40",
            "union_debit_rate": "41",
            "bank_debit_max": "2000",
            "union_credit_rate": "43",
            "union_mix_rate": "44",
            "union_debit_max": "2000"
        },
        "ali": {
            "rate": "38",
            "channel_no": "2088631598508348",
            "mcc": "0742",
            "business_id": "2015050700000000"
        }
    },
    "accessid": "cpostest",
    "sign": "D9DB188B65F3FC67C678145A058075A2"
}

返回参数说明:

参数 参数名称 类型 参数说明 样例 可空
return_code 返回码 String 10000 M
return_msg 返回信息 String 申请成功 M
merch_no SAAS平台商户编号 String 11001088888888 M
contract_no 电签合同编号 String 电子签章合同编号 O
sign_url 电子签约链接 String 电子签约链接地址 O

返回示例:

{
    "merch_no": "833102154620282",
    "return_code": 10000
}
文档更新时间: 2024-12-20 16:23   作者：王金晶