3.2【会员进件】接口

字段

字段类型

字段长度

必填

字段名称

说明

reqTraceNum

String

50

是

进件请求流水号

signNum

String

60

是

商户会员编号

notifyUrl

String

256

是

会员进件结果通知地址

merAddBasicInfo

JSONObject

是

会员基本信息

merAddBeneficiaryInfo

JSONObject

是

受益人信息

merAddBankAcctInfo

JSONObject

是

银行账户信息

merAddProductInfo

JSONArray

是

开通产品信息

merAddBranchInfo

JSONArray

是

门店信息

merAddAttachmentInfo

JSONObject

是

附件材料

字段

字段类型

字段长度

必填

字段名称

取值

reqTraceNum

String

50

是

进件请求流水号

业务正常处理，则返回

respTraceNum

String

40

是

响应流水号

业务正常处理，则返回

respCode

String

5

是

业务返回码

00000：代表成功

66666、66667：处理中，即当前的请求已受理，需要继续调用关联的确认类接口，或通过发起订单查询、等待异步通知，来获取处理状态。

其他返回码：均代表失败

respMsg

String

200

否

业务返回说明

signNum

String

60

是

商户会员编号

auditStatus

String

否

审核状态

respCode为00000-交易成功时返回

00-受理成功待提交审核

01-审核中

02-审核通过

03-审核失败

04-提交审核失败

字段

字段类型

字段长度

必填

字段名称

说明

cusName

String

100

是

商户名称

会员性质为个人时，需按照 个人+法人姓名+随机数的格式生成；

如商户名称已存在，会自动在名称后加随机数字发往渠道

cusSimName

String

40

是

商户简称

无执照商户请按照实际场所的经营门店名称填写，会员性质为个人时，需按照 个人+法人姓名（+随机数）的格式生成

cusEnName

String

100

否

商户英文名称

开通外卡产品时必填

cusEnSimName

String

100

否

商户英文简称

开通外卡产品时必填

comProperty

String

1

是

商户性质：

1.企业 3.个体户 4.个人 6.事业单位

商户性质为4时，为云商通的个人会员，其他时均为企业会员

servicePhone

String

32

是

客服电话

mcc

String

8

是

所属行业

请咨询通联支付客户经理

corpBusName

String

64

否

营业执照名称

creditCode

String

32

否

统一社会信用代码

creditCodeExpire

String

10

否

统一社会信用代码证件有效期

格式：9999-12-31

若长期有效上送“9999-12-31”

legalName

String

20

是

法人姓名

legalIdType

String

2

是

法人证件类型

legalIdNo

String

50

是

法人证件号码

SM4加密，详细

legalIdStartdate

String

10

是

法人证件有效开始日期

格式：YYYY-MM-DD

legalIdExpire

String

10

是

法人证件有效截止日期

格式：YYYY-MM-DD

address

String

200

是

注册地址需包含省市

contactPerson

String

30

是

商户负责人

contactPhone

String

20

是

商户负责人电话

registerFund

String

20

否

注册资本

会员性质为企业、个体户时必填

1: 注册资本<10万元

2: 10万元<注册资本<20万元

3: 20万元<注册资本<50万元

4: 50万元<注册资本<100万元

5: 注册资本>100万元

staffTotal

String

10

否

员工人数

会员性质为企业、个体户时必填

1: 员工数量<10

2: 10<员工数量<20

3: 20<员工数量<50

4: 50<员工数量<100

5: 员工数量>100

operateLimit

String

1

否

经营区域

会员性质为企业、个体户时必填

1：城区

2: 郊区

3：边远地区

inspect

String

1

否

经营地段

会员性质为企业、个体户时必填

1：商业区

2：工业区

3：住宅区

busConactPerson

String

32

否

业务联系人姓名

会员性质非个人时必填

busConactTel

String

20

否

业务联系人电话

会员性质非个人时必填

offlag

String

1

否

线上线下业务场景

0  线下

1  线上

为空时默认为线下场景

cusUrl

String

100

否

网站url或下载地址或平台名称

开通网关（含B2B、APP）、快捷、云闪付APP或线上场景必填

webName

String

50

否

网站名称/应用名称

开通网关（含B2B、APP）、快捷、云闪付APP或线上场景必填

busDetail

String

100

是

经营内容

businessPlace

String

1

否

经营场所

1、独立门店、连锁店、专卖店

2、综合卖场

3、批发市场

4、其它

为空时默认填1

busAddress

String

60

是

经营地址

districtCode

String

10

是

经营地址所在区

详见地区码表

icpInfo

String

30

否

icp备案号

appScenario

String

10

否

应用场景

01-PC网站 02-APP/公众号/小程序（可复选，复选上送01,02）

personTel

String

11

是

法人手机号

expandUser

String

 50

是

拓展人

请咨询通联支付客户经理

clearTimeRule

 2

否

结算时间

详见枚举值

字段

字段类型

字段长度

必填

字段名称

说明

legalCountry

String

是

法人国籍

legalSex

String

是

法人性别

1：男

2：女

legalCareer

String

是

法人职业

1：国家机关、党群组织、企业、事业单位人员

2：专业技术人员

3：办事人员和有关人员

4：商业、服务业人员

5：农、林、牧、渔、水利业生产人员

6：生产、运输设备操作人员及有关人员

7：军人

8：其他

legalAddress

String

是

法人住址

merchantType

String

否

商户类型

企业、事业单位时必填，

见枚举值

beneficiaryJudgmentCriteria

String

否

受益所有人判定标准

以下情况必填：

当商户类型=公司（不包含国有企业）/合伙企业时，判定标准如下：

1-拥有超过25%合伙权益的自然人

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

3-执行事务合伙人

beneficiaryJudgmentFile

String

否

受益所有人证明材料类型

“商户类型”选择为“公司（不包含国有企业）”、“合伙企业”的，支持上传受益所有人判定的证明材料

枚举值：

61:注册证书(受益人)
62:存续证明文件(受益人)
63:公司章程(受益人)
64:合伙协议(受益人)
65:备忘录(受益人)
66:股权结构图(受益人)

67:年报(受益人)
68:其他(受益人)

当“商户类型”字段选择“公司（不包含国有企业）”时,则“证明材料”字段不可上送“64”；

beneficiaryCerType

String

否

受益人证件类型

非个人类商户必填

1：身份证
5：台湾通行证
9：港澳通行证

beneficiaryName

String

否

受益人姓名

非个人类商户必填

beneficiaryCerNum

String

否

受益人证件号码

非个人类商户必填

SM4加密

beneficiaryCerValidate

String

否

受益人证件证件有效期

非个人类商户必填

格式：YYYY-MM-DD

isSeniorManagement

String

否

是否为高管

非个人类商户必填

0 否 1是

beneficiaryAddress

String

否

受益人住址

非个人类商户必填

shareholderName

String

否

控股股东姓名

会员性质为企业、个体户时必填

shareholderCerNum

String

否

控股股东证件号码

会员性质为企业、个体户时必填，SM4加密

shareholderCerValidate

String

否

控股股东证件有效期

会员性质为企业、个体户时必填，格式：YYYY-MM-DD

字段

字段类型

字段长度

必填

字段名称

说明

pid

String

是

产品类型

详见枚举值

mtrxCode

String

是

交易类型

详见枚举值

feeRate

String

是

费率

单位：千分之

creditRate

String

否

信用卡费率

单位：千分之，区分借贷分离时必填

feePen

String

否

元/笔

仅当网上收银-网关B2B 时配置，其他交易类型为空

lowLimit

String

否

保底（仅支持借记卡）

单位：元

topLimit

String

否

封顶（仅支持借记卡）

单位：元

字段

字段类型

字段长度

必填

字段名称

说明

branchNo

4

否

门店编号

进件时为空

branchName

60

是

门店名称

同一商户名称唯一

branchAddr

150

是

门店地址

进件时必填

contactPerson

30

是

门店联系人

进件时必填

contactPhone

20

是

门店联系人电话

进件时必填

districtCode

10

是

所在区

进件时必填

以下字段仅在商户进件时需配置终端的门店信息中存在：

printNum

2

否

打印联数

默认为2,

termNum

1

否

门店终端数

单门店最大终端数：5

rejectTrxCodes

100

否

禁用交易类型(多个使用逗号分隔)

VSP002 消费撤销

VSP003 消费退货

VSP004 预授权

VSP005 预授权撤销

VSP006 预授权完成

VSP007 预授权完成撤销

VSP502 微信撤销

VSP503 微信退货

VSP512 支付宝撤销

VSP513 支付宝退货

VSP506 QQ钱包撤销

VSP507 QQ钱包退货

VSP552 银联扫码撤销

VSP553 银联扫码退货

VSP011 扫码预消费

VSP013 扫码预消费完成

VSP014 扫码预消费完成退货

仅在商户进件需配置终端时填写

字段

字段类型

必填

字段名称

说明

acctAttr

String

否

账户类型

0：对私（银行账户名称默认为法人姓名）

1：对公（银行账户名称默认为企业名称）

商户性质=企业/事业单位，默认1-对公，不支持上送0-对私；

商户性质=个体工商户，支持上送0-对私/1-对公，不填默认1-对公；

商户性质=个人，默认0-对私，不支持上送1-对公

acctNum

String

是

账号

对公户支持数字和“-”字符

SM4加密，详细

bankReservePhone

String

否

银行预留手机

账户类型=0-对私时需要填写

openBankNo

String

否

银行代码

账户类型=1-对公时需要填写

openBankBranchName

String

否

开户行支行名称

如：“中国工商银行股份有限公司北京樱桃园支行”

账户类型=1-对公时需要填写

payBankNumber

String

否

支付行号，12位数字

账户类型=1-对公时需要填写，

详见

openBankProvince

String

是

开户行所在省

根据中国省市表的“省份”内容填写，中文。详情

账户类型=1-对公时需要填写

openBankCity

String

是

开户行所在市

根据中国省市表的“城市”内容填写，中文。详情

账户类型=1-对公时需要填写

字段

字段类型

必填

字段名称

说明

unifiedSocialCreditPhoto

String

否

统一信用证照片

legalNationalEmblemPhoto

String

否

法人证件（国徽面）

legalFacePhoto

String

否

法人证件（肖像面）

settleAcctPhoto

String

否

结算账户照

legalPic

String

否

经营者手持身份证照片

businessDoorHeadPhoto

String

是

经营门头照片

businessInteriorPhoto

String

是

经营内景照片

bizPlacePic

否

经营场所证明文件

不限于营业场所租赁协议或者产权证明、集中经营场所管理方出具的证明文件等

会员性质个人时需要填写

otherFile

否

其他审核材料

所有其他审核材料打包成zip提交(注：压缩包里不能放入文件夹)

personHeadPic

String

否

经营者与店铺门头合照

会员性质为个人时必填

beneficiaryFile

String

否

受益所有人证明材料

字段

字段类型

字段长度

必填

字段名称

说明

reqTraceNum

String

50

是

进件请求流水号

商户系统内保持唯一，定义长度为50位

signNum

String

60

是

商户会员编号

respCode

String

5

是

业务返回码

respMsg

String

200

否

业务返回说明

auditStatus

String

1

是

审核状态

01-审核中

02-审核通过

03-审核失败

04-提交审核失败

cusId

String

32

否

通联收银宝商户号

事后校验通过时返回