7. 商户开户或入驻

7.1. 应用场景

该接口功能包含如下：

  • 仅盛付通商户开户，不申请微信、支付宝、云闪付的收单商户

  • 开通线下聚合支付的收单商户

警告 该接口参数很多，其请求串长度远远超出 HTTP GET 允许的长度，因此请使用 POST 请求。

7.2. 特别说明

该接口支持聚合云闪付支付，已支持 POS （含刷卡）。

7.3. 接口地址

生产环境：https://guanj.51wanquan.com/agent/account/register

7.4. 请求报文

参数名

类型

是否可选

描述

agent_appid

String

M

服务商开发者APPID

virtual_agent

String

M

虚拟代理商ID，以 「可使用的虚拟代理商」为准

7.4.1. 商户基本资料

参数名

类型

是否可选

描述

registerType

Integer

M

商户开户类型（1 盛付通商户开户 2 收单商户进件）

subjectType

Integer

M

主体类型，参看 商户账户类型

applyType

Integer

M

申请方式，当前固定值为 1

loginAccount

String

M

登录盛付通后台的手机号或者email（建议手机号）

mcc

String

M

行业类目，以 「 行业类目 」 或 「商户类别代码MCC」为准

notifyUrl

String

O

回调通知URL

notifyAccount

Integer

O

是否通知联系人用户名和登录名密码（1 为通知，0 为不通知；默认不通知）

signMode

Integer

O

签约方式 1 电子签约 2 纸质合同签约（收单商户进件必填，建议优先考虑电子签约）

7.4.2. 联系人信息

应微信进件要求，商务联系人为非法人时，需提供其身份证件信息

参数名

类型

是否可选

描述

contactType

Integer

M

商务联系人类型（1 法人 2 非法人）

contactName

String

M

商务联系人姓名

contactPhone

String

M

商务联系人手机

contactEmail

String

M

商务联系人邮箱

contactIdDocNumber

String

O

商务联系人身份证号，非法人时必传

contactIdDocCopy

String

O

商务联系人证正面照（人像面），图片上传接口的 mediaId；非法人时必传

contactIdDocNational

String

O

商务联系人身份证反面照（国徽面），图片上传接口的 mediaId；非法人时必传

contactIdPeriodBegin

String

O

商务联系人身份证起始有效期，格式为YYYY-MM-DD；非法人时必传

contactIdPeriodEnd

String

O

商务联系人身份证结束有效期，格式YYYY-MM-DD，有效期永久时传入，2199-12-31；非法人时必传

7.4.3. 经营者/法人身份证件

参数名

类型

是否可选

描述

idDocType

Integer

M

证件类型，固定值为 1

idDocName

String

M

法人身份证姓名

idDocNumber

String

M

法人身份证号

idDocCopy

String

M

法人身份证正面照（人像面），图片上传接口的 mediaId

idDocNational

String

M

法人身份证反面照（国徽面），图片上传接口的 mediaId

docPeriodBegin

String

M

法人身份证起始有效期，格式为 yyyy-MM-dd

docPeriodEnd

String

M

法人身份证结束有效期，格式为 yyyy-MM-dd；永久有效请填写 2199-12-31

idDocAddress

String

M

法人证件上的居住地址，若证件上无，则传入法人实际居住地址

handDocImg

String

O

法人手持身份证照片，小微商户必填

7.4.4. 营业执照信息

企业/个体工商户必填，小微不需要

参数名

类型

是否可选

描述

merchantName

String

M

营业执照商户名称

licenseNumber

String

M

营业执照号/统一社会信用代码

licenseCopy

String

M

营业执照图片，图片上传接口的 mediaId

licensePeriodBegin

String

M

营业执照起始有效期，格式为 yyyy-MM-dd

licensePeriodEnd

String

M

营业执照结束有效期，格式为 yyyy-MM-dd；永久有效请填写 2199-12-31

7.4.5. 签约产品信息

仅限收单商户进件时为必填

参数名

类型

是否可选

描述

productList

JsonString

M

至少包含一个产品

7.4.5.1. 产品数据结构

参数名

类型

是否可选

描述

bizProductCode

String

M

产品名称

feeValue

String

M

费率值，如 0.003 表示费率为千分之三，即 0.3%（注意是设置给客户的收单手续费费率，不可低于成本费率）

posValue

String

O

银联云闪付、POS 1000元以上费率（1000元【含】以内同 feeValue ；银联云闪付、POS必填）

maxFee

String

O

封顶值(仅借记卡支付，默认不封顶)

7.4.5.2. 可用产品名称

值

描述

1

线下 POS 贷记卡支付

2

线下 POS 借记卡支付

3

线下微信聚合支付（默认包含微信小程序支付）

4

线下支付宝聚合支付

6

线下银联借记卡聚合支付

7

线下银联贷记卡聚合支付

8

线下微信小程序聚合支付（仅限单独设置费率时使用；不允许单独签约微信小程序支付）

9

微信预授权（默认含微信小程序预授权）(需同时开通「线下微信聚合支付」)

10

微信小程序预授权(仅限单独设置费率)(需同时开通「线下微信聚合支付」)

11

支付宝预授权(需同时开通「线下支付宝聚合支付」)

12

银联云闪付借记卡预授权(需同时开通「线下银联借记卡聚合支付」)

13

银联云闪付贷记卡（信用卡）预授权(需同时开通「线下银联贷记卡聚合支付」)

7.4.5.3. 预授权产品补充说明

  • 商户类型为企业或个体户，小微商户无此选项

  • 校验商户全称和工商网鉴权返回的经营范围，包含以下关键字之一：旅馆、酒店、住宿、出租、租赁、租借、用房

  • 行业类目选择以下类型的商户：

MCC

MCC说明

7011

住宿服务

7012

分时使用的别墅或度假用房

4457

出租船只

5978

打字机商店-销售、服务和出租

7296

出租衣物

7394

设备、工具、家俱和电器出租

7512

汽车出租

7513

卡车及拖车出租

7519

房车和娱乐车辆出租

7841

出租录像带服务

7.4.6. POS 终端信息

仅限收单商户进件，且签约 POS 产品时为必填

参数名

类型

是否可选

描述

terminalList

JsonString

M

至少包含一个终端

7.4.6.1. 终端数据结构

根据人行 POS 终端相关监管要求，POS 申请安装地址限定在同一市域，请注意申请填写。 另，小票名称与安装详细地址一致时，请修改「终端数量」，而不是新增同样的终端信息。

参数名

类型

是否可选

描述

ticketName

String

M

小票名称

terminalCount

Integer

M

POS 终端数量，至少为 1

terminalCityId

String

M

POS 终端安装所在市编码，以 「 省市区编号对照表 」 或 「商户进件省市区信息」为准

terminalDetailAddress

String

M

POS 终端安装详细地址

7.4.7. 经营信息

企业、个体工商户、小微均可选， 收单商户进件时所有条目为必填

参数名

类型

是否可选

描述

storeName

String

O

经营店铺名称/简称

storeEntrancePic

String

O

经营店铺门头照，图片上传接口的 mediaId

frontDeskPic

String

O

经营店铺前台照，图片上传接口的 mediaId

indoorPic

String

O

经营店铺内部照，图片上传接口的 mediaId

storeCountyId

String

M

经营场所在区编码，以 「 省市区编号对照表 」 或 「商户进件省市区信息」为准

storeAddress

String

M

经营场所详细地址

wxBusinessAuthLetter

String

O

微信业务办理授权函，图片上传接口的 mediaId（非法人作为联系人时需上传）; 下载 微信业务办理授权函 模版

7.4.8. 结算银行账户信息

企业/个体工商户可支持非同名对私结算，对公则必须同名；小微商户只能同名结算。

参数名

类型

是否可选

描述

bankAccountBelongType

Integer

M

结算银行账户类型（1 同名 2 非同名 非必要，不建议使用非同名）

bankAccountType

Integer

M

结算银行卡类型(1 对公 2 对私)，同名是企业必须对公

accountName

String

M

结算银行卡账户名称

bankAccount

String

M

结算银行卡账户

bankName

String

O

结算银行名称（对公结算必填），以 「银行列表」为准

bankCityId

String

O

结算银行卡分支行所在市编码（对公结算必填），以 「 省市区编号对照表 」 或 「商户进件省市区信息」为准

bankBranchName

String

O

结算银行卡分支行名称（对公结算必填），请以实际为准

bankPhoneNo

String

O

银行预留手机号

bankAccountPic

String

M

对公开户许可证图片或者对私银行卡照片，图片上传接口的 mediaId

bankIdDocNumber

String

O

企业或者个体工商户非法人结算持卡人身份证号（非同名结算时必填）

bankIdDocCopy

String

O

企业或者个体工商户非法人结算持卡人身份证正面（人像面），图片上传接口的 mediaId（非同名结算时必填）

bankIdDocNational

String

O

企业或者个体工商户非法人结算持卡人身份证反面照（国徽面），图片上传接口的 mediaId（非同名结算时必填）

bankDocPeriodBegin

String

O

企业或者个体工商户非法人结算持卡人身份证有效期起始时间，格式为YYYY-MM-DD（非同名结算时必填）

bankDocPeriodEnd

String

O

企业或者个体工商户非法人结算持卡人身份证有效期结束时间，格式为YYYY-MM-DD，有效期永久时传入，2199-12-31（非同名结算时必填）

autoWithdraw

Integer

M

是否开通自动结算（1 为开通，0 为不开通；默认不开通）

7.4.9. 同名结算银行账户信息

同名银行账户信息，非同名结算必传；同名时不需要

参数名

类型

是否可选

描述

mchBankAccountType

Integer

M

结算银行卡类型(1 对公 2 对私)，企业开户必须对公

mchAccountName

String

M

银行卡账户名称，对公必须和营业执照上名称一致，个体工商户对私必须和法人名称一致

mchBankAccount

String

M

结算银行卡账户

mchBankName

String

M

结算银行名称（对公结算必填），以 「银行列表」为准

mchBankCityId

String

M

结算银行卡分支行所在市编码（对公结算必填），以 「 省市区编号对照表 」 或 「商户进件省市区信息」为准

mchBankBranchName

String

M

结算银行卡分支行名称（对公结算必填），请以实际为准

mchBankAccountPic

String

M

对公开户许可证图片或者对私银行卡照片，图片上传接口的 mediaId

7.4.10. 受益人信息

签约微信支付产品，商户类型为企业时需填写；未签约微信支付产品或商户类型为个体工商户和小微时不需要。

若经营者/法人不是最终受益所有人，则需提填写受益所有人信息。

根据国家相关法律法规，需要提供公司受益所有人信息，受益所有人需符合至少以下条件之一：

  1. 直接或者间接拥有超过25%公司股权或者表决权的自然人。

  2. 通过人事、财务等其他方式对公司进行控制的自然人。

  3. 公司的高级管理人员，包括公司的经理、副经理、财务负责人、上市公司董事会秘书和公司章程规定的其他人员。

参数名

类型

是否可选

描述

uboList

JsonString

O

应包含所有受益人信息

7.4.10.1. 受益人条目数据结构

参数名

类型

是否可选

描述

idDocType

Integer

M

受益人证件类型（详见下面的 受益人证件类型 ）

idDocName

String

M

受益人证件姓名

idDocNumber

String

M

受益人证件号

idDocCopy

String

M

受益人证件正面照（身份证为人像面），图片上传接口的 mediaId

idDocNational

String

M

受益人证件反面照（身份证为国徽面，其他证件同正面照），图片上传接口的 mediaId

docPeriodBegin

String

M

受益人证件有效期开始时间，格式为YYYY-MM-DD

docPeriodEnd

String

M

受益人证件有效期结束时间，格式为YYYY-MM-DD，有效期永久时传入，2199-12-31

idDocAddress

String

M

受益人证件上的地址或实际居住地址

7.4.10.2. 受益人证件类型

值

描述

1

中国大陆居民身份证

6

护照

8

中国香港居民来往内地通行证

9

中国澳门居民来往内地通行证

5

中国台湾居民来往大陆通行证

10

港澳居民证

11

台湾居民证

12

外国人居留证

7.4.11. 其它证明材料

针对一些特殊行业（如药店）需要补充证明材料时，统一放在该字段内

参数名

类型

是否可选

描述

pageContractNo

String

O

纸质合同编号，由 BD 提供（纸质签约时必填，非必要建议电子签约）

pageContractPics

JsonString

O

纸质合同图片上传接口的 mediaId 集合，类似 "pageContractPics":"[\"678640178801893376\",\"678640179875639296\"]"

businessAdditionPics

JsonString

O

其它证明材料图片上传接口的 mediaId 集合，类似 "additionInfos":"[\"678640178801893376\",\"678640179875639296\"]"

可参考：

https://kf.qq.com/faq/220228IJb2UV220228uEjU3Q.html

https://kf.qq.com/faq/220228qEfuAz220228bMFji6.html

7.5. 响应报文

1{
2    "status": "SUCCESS",
3    "data": {
4        "businessCode": "2749720820",
5    }
6}

响应字段

类型

描述

status

String

响应状态 SUCCESS 为成功，否则为失败

data

Array

响应业务参数

7.5.1. data 相关描述

响应字段

类型

描述

businessCode

String

申请单编号