3.4【企业会员实名开户】接口

测试地址：https://ibstest.allinpay.com/yst/yst-service-api/tm/handle

生产地址：https://ibsapi.allinpay.com/yst-service-api/tm/handle

接口代码（transCode）：1020

功能说明：

1.开户场景：

（1）支持未实名的企业会员在银行侧开户+绑卡；

（2）企业会员实名认证流程：按顺序触发-企业工商要素验证->法人实名认证（非身份证，则不做认证）->对公银行账户信息留存/对私银行账户认证：三个认证环节均通过，则发送银行认证，银行认证完成则开户成功；

（3）支持上送影印件信息，当企业会员工商信息、法人实名信息、银行账户信息通联+银行侧认证成功，则会员状态=有效时，进行影印件OCR识别比对，并通过【会员资料补录结果通知】（接口代码1022）接口通知商户影印件OCR识别比对结果、【企业会员簿记开户审核结果通知】（接口代码1020）通知商户企业审核结果；

2.一个会员仅支持开通一个银行子账户，接口实时响应银行子账户开户结果和绑卡结果；

3.开户成功后：

（1）【企业会员管理】菜单保存个人会员信息；

（2）【银行子账户信息管理】菜单落地会员与子账户信息；

（3）若绑卡成功，【银行卡管理】菜单保存会员银行卡信息；

4. 同一个证件开户数：

中信银行：一个证件号可注册用户个数未明确限，按银行风控模型识别出来冻结账户；

华通银行：默认同一身份证号码可开户的最大数量限制为2个；

民生银行；默认同一证件号可开户个数99个；

5.绑卡个数：建议一个用户最好仅绑定一个银行账户；

中信托管：

1、中信银行企业会员开户，银行侧自动完成工商认证+法人认证+对公账户打款验证（系统自动），实时响应银行子账户开户结果及绑卡结果；

2.支持个体工商户绑定法人卡；

华通托管：

1、华通银行企业会员（对公户）开户，企业用户信息待银行人工审核，人工审核通过，通过【企业会员簿记开户审核结果通知】接口告知审核结果；

2、针对个体工商户：户名是经营者个人名字，则绑卡只能绑个人的对私卡。户名是企业工商名称，则仅绑定对公户（不支持个体工商户既绑定对公又绑定对私账户）。

注：华通银行需平台客户在银行侧申请开通免对公打款验证。

民生银行：企业会员开户，银行侧自动完成工商认证+法人认证+对公账户验证，实时响应银行子账户开户结果及绑卡结果；不支持个体工商户绑卡法人卡；

业务请求参数

字段	字段类型	字段长度	必填	字段名称	说明
reqTraceNum	String	50	是	商户请求流水号	商户系统内保持唯一，定义长度为50位
signNum	String	60	是	商户会员编号
memberRole	String	60	否	会员角色	（1）未注册，必须上送角色（2）已注册，无需上送，上送则需要与设置的角色一致说明：测试环境，会员角色枚举值详见【接入指引-联调测试】模块
notifyUrl	String	256	是	企业会员审核结果通知地址	如下情况，企业会员信息实名成功/失败均发送通知：（1）接口自动完成实名（2）运营平台人工审核后
enterpriseBaseInfo	JSONObject		是	企业基本信息	详细
bankAcctDetail	JSONObject		是	银行账户信息	详细
enterpriseDetail	JSONObject		否	企业详情信息	华通银行，必填民生银行，必填详情
bankAcctReqInfo	JSONObject		否	银行开户请求信息	银行托管模式，需请求银行，则上送详情

企业基本信息JSON（enterpriseBaseInfo）

字段	字段类型	必填	字段名称	说明
enterpriseName	String	是	企业名称	如有括号，用中文格式（）
enterpriseNature	String	否	企业性质： 1-企业 2-个体工商户 3-事业单位	不填，则默认“企业” 注：企业名称含“公司”，不支持上送“个体工商户”
addressCode	String	是	地区码（企业注册地所在省市区）	见数据字段
enterpriseAdress	String	是	企业注册地地址
unifiedSocialCredit	String	是	统一社会信用
busLicenseValidate	String	否	营业证件有效期	针对华通银行（企业性质），必填
busLicenseLicEffDate	String	否	营业执照生效日期	针对华通银行（企业性质），必填
legalPersonName	String	是	法人姓名
legalPersonCerType	String	是	法人证件类型	详细
legalPersonCerNum	String	是	法人证件号码	SM4加密，详细
idValidateStart	String	否	法人证件有效开始日期	格式：9999-12-31 华通银行，必填
idValidateEnd	String	否	法人证件有效截止日期若长期有效上送“9999-12-31”	格式：9999-12-31 若长期有效上送“9999-12-31” 华通银行，必填
legalPersonPhone	String	是	法人手机号码	注意：此手机号在绑定手机时会进行法人运营商三要素验证。
legalPersonCountry	String	否	法人国籍	针对华通银行（企业性质），必填若是中国，上送“CHN”
legpCerFrontFileId	String	否	法人身份证（肖像面）token	通过【文件上传下载接口】上传文件图片后获取的fileId，有效期30分钟，图片不超过2M 法人身份证证件类型：肖像面和国徽面必须同时上传。法人非身份证证件类型：仅上传“法人身份证（肖像面）token”即可。华通银行，必填
legpCerBackFileId	String	否	法人身份证（国徽面）token
unifiedSocialCreditFileId	String	否	统一信用证token

银行账户信息JSON(bankAcctDetail)

字段	字段类型	必填	字段名称	说明
acctAttr	String	否	账户类型	0-对私（银行账户名称默认为法人姓名） 1-对公（银行账户名称默认为企业名称）企业性质=企业/事业单位，默认1-对公，不支持上送0-对私；企业性质=个体工商户，支持上送0-对私/1-对公，不填默认1-对公；
acctNum	String	是	账号	账户类型=1-对公，企业对公账户，支持数字和“-”字符账户类型=0-对私，则上送对私账户（借记卡） SM4加密，详细
bankReservePhone	String	否	银行预留手机	账户类型=0-对私，则必填
openBankNo	String	否	银行代码	对公：根据基础数据，上送“银行代码”字段,必填对私：无需上送，系统自动根据卡BIN识别银行。
openBankBranchName	String	否	开户行支行名称	如：“中国工商银行股份有限公司北京樱桃园支行” 账户类型=1-对公，则必填
payBankNumber	String	否	支付行号，12位数字	账户类型=1-对公，则必填
openBankProvince	String	是	开户行所在省	开户行所在省开户行所在市必须同时上送根据中国省市表的“省份”内容填写。
openBankCity	String	是	开户行所在市	开户行所在市开户行所在省必须同时上送根据中国省市表的“城市”内容填写。

新增【企业详细信息】对象（enterpriseDetail）

字段	字段类型	必填	字段名称	说明
enterpriseScale	String	否	企业规模	针对华通银行（企业性质），必填详情
enterpriseType	String	否	企业类型	针对华通银行（企业性质），必填详情
economicNature	String	否	企业经济性质	针对华通银行（企业性质），必填详情
country	String	否	国籍	针对华通银行，必填详情
regCapital	String	否	企业注册资本单位：元	针对华通银行（企业性质），必填
occupation	String	否	行业说明：个体工商户，上送职业枚举值	针对华通银行，必填详情
businessBeginDate	String	否	公司经营开始时间格式：yyyy-MM-dd	针对华通银行（企业性质），必填
businessEndDate	String	否	公司经营结束日期格式：yyyy-MM-dd	针对华通银行（企业性质），必填
contactMobile	String	否	企业联系人手机号	针对华通银行（企业性质），选填
regProvinceCode	String	否	注册地所在省	针对华通银行（企业性质），必填
regCityCode	String	否	注册地所在市	针对华通银行（企业性质），必填
regAreaCode	String	否	注册地所在区县	针对华通银行（企业性质），必填
linkProvinceCode	String	否	企业联系地所在省	针对华通银行（企业性质），必填
linkCityCode	String	否	企业联系地所有市	针对华通银行（企业性质），必填
linkAreaCode	String	否	企业联系地所在县	针对华通银行（企业性质），必填
enterpriseAddress	String	否	经营详细地址/企业联系地址	针对华通银行（企业性质），必填
businessScope	String	否	经营范围	针对华通银行（企业性质），选填
openLicenseCode	String	否	开户许可证核准号或基本存款账户编号	针对华通银行（企业性质），选填
openLicenseToken	String	否	开户许可证文件	针对华通银行（企业性质），选填
shareholderInfo	JSONArray	否	控股股东/实际控制人	针对华通银行（企业性质），必填，仅需要上送一条控制人信息即可详情
beneficiaryInfo	JSONArray	否	受益所有人信息	针对华通银行（企业性质），必填，按照实际情况填写详情
leiCode	String	否	全球法人识别编码	华通银行，境外企业时如有需要输入
zcFileId	String	否	企业章程token	通过【文件上传下载接口】上传文件图片后获取的fileId 1、上传每张图片不超过2M大小。 2、章程扫描件等图片的格式为jpg\jpeg\png\gif\bmp。章程或佐证材料合成一张图片，不支持压缩包。仅章程支持pdf格式华通银行，必填
qtFileId	String	否	佐证材料token
contactInfo	JSONObject	否	企业联系人信息	民生银行，必填详情

新增【控股股东/实际控制人】对象（shareholderInfo）

字段	字段类型	必填	字段名称	说明
shareholderName	String	否	控股股东/实际控制人名称	华通银行，必填
shareholderCertType	String	否	控股股东/实际控制人证件类型	华通银行，必填
shareholderCertNo	String	否	控股股东/实际控制人证件号	无需加密，明文华通银行，必填
shareholderCertBeginDate	String	否	控股股东/实际控制人证件开始日期	华通银行，必填
shareholderCertEndDate	String	否	控股股东/实际控制人证件截止日期	华通银行，必填
shareholderPhone	String	否	股东或实际控制人电话	华通银行，必填
shareholderCountry	String	否	股东或实际控制人国籍	华通银行，需上送，不上送默认“CHN”

新增【受益所有人】对象（beneficiaryInfo）

字段	字段类型	必填	字段名称	说明
beneficiaryName	String	否	受益所有人名称	华通银行，必填
beneficiaryAddress	String	否	受益所有人地址	华通银行，必填
beneficiaryPhone	String	否	受益所有人电话	华通银行，必填
beneficiaryIdType	String	否	受益所有人证件类型	华通银行，必填
beneficiaryIdNo	String	否	受益所有人证件号码	无需加密，明文华通银行，必填
beneficiaryIdEffDate	String	否	受益所有人证件开始日期	格式：yyyy-MM-dd 华通银行，必填
beneficiaryIdOffDate	String	否	受益所有人证件到期日期	华通银行，必填
beneficiaryCountry	String	否	受益所有人国籍	华通银行，必填
beneficiarySex	String	否	受益人性别	华通银行：证件类型为非身份证时必输，证件类型为身份证时可不输；男性：1 女性：2
beneficiaryBirth	String	否	受益人出生日期	华通银行：证件类型为非身份证时必输，证件类型为身份证时可不输
beneficiaryLandline	String	否	受益人固定电话	格式：021-67034567
items(数组)				华通银行，必填
beneficiaryType	String	否	受益所有权关系类型	华通银行，必填 100 股权/合作权益 200 收益权/表决权 300 实际控制 400 负责日常经营管理的（高级管理）人员 500 在华最高层级高级管理人员
equityRate	String	否	股权 / 合伙权益比例	关系类型为“100-股权/合作权益”时，采集的数据项
equityStartDate	String	否	受益所有权形成日期
equityExpiryDate	String	否	受益所有权终止日期
benefitsRate	String	否	收益权比例	关系类型为“200-收益权/表决权信息”时，采集的数据项规则：收益权、表决权组合要素必须有一组组合要素有值
benefitsStartDate	String	否	收益所有权形成日期
benefitsExpiryDate	String	否	收益所有权终止日期
votingRate	String	否	表决权比例
votingStartDate	String	否	表决所有权形成日期
votingExpiryDate	String	否	表决所有权终止日期
actualControlType	String	否	实际控制方式	关系类型为“300-实际控制”时，采集的数据项协议约定形式:310 其他形式:320
otherRemark	String	否	其他形式备注信息实际控制为“其他形式”时，该数据项必填
equityStartDate	String	否	受益所有权形成日期
equityExpiryDate	String	否	受益所有权终止日期
mangerPosition	String	否	负责日常经营管理的（高级管理）人员职位法定代表人：300；董事长：111；总经理：112；董事：121；合伙人：128；其他：160	关系类型为“400-负责日常经营管理的（高级管理）人员”时，采集的数据项
otherPosition	String	否	公司章程规定的其他（高级管理）人员的具体职位职位为其他时该数据项必填
equityStartDate	String	否	受益所有权形成日期
equityExpiryDate	String	否	受益所有权终止日期
chnMangerPosition	String	否	在华最高层级高级管理人员职位分支机构负责人：510；其他高级管理人员：520	关系类型为“500-在华最高层级高级管理人员”时，采集的数据项
chnOtherPosition	String	否	在华最高层级的高级管理其他职位职位为其他高级管理人员时该数据项必填
equityStartDate	String	否	受益所有权形成日期
equityExpiryDate	String	否	受益所有权终止日期

新增【企业联系人】对象（contactInfo）

字段	字段类型	必填	字段名称	说明
contactName	String	否	企业联系人姓名	民生银行必填
contactPhone	String	否	企业联系人电话	民生银行必填
contactCertType	String	否	企业联系人证件类型	民生银行必填
contactCertNum	String	否	企业联系人证件号码	明文上送民生银行必填
contactCertBeginDate	String	否	联系人证件起始日期	格式：9999-12-31
contactCertEndDate	String	否	联系人证件截止日期	长期则上送：9999-12-31
contactCertFrontId	String	否	企业联系人身份证（肖像面）token
contactCertFrontId	String	否	企业联系人身份证（国徽面）token
contactAuthFileId	String	否	企业联系人授权书开放平台文件id

响应请求参数

字段	字段类型	字段长度	必填	字段名称	说明
respTraceNum	String		否	响应流水号	业务正常处理，则返回
signNum	String		否	商户会员编号
bankAcctResInfo	JSONObect		否	银行开户响应信息	详情说明：银行托管模式，响应开户银行子账户信息
respCode	String		是	业务返回码	00000：代表成功 66666、66667：处理中，即当前的请求已受理，需要继续调用关联的确认类接口，或通过发起订单查询、等待异步通知，来获取处理状态。其他返回码：均代表失败
respMsg	String		是	失败原因	法人非身份证证件类型：法人证件类型非身份证类型，需人工审核；
openBankNo	String	8	否	银行代码	仅绑定对私卡时返回根据绑定的卡BIN识别对应银行代码字典
bankName	String	200	否	银行名称

【企业会员簿记开户审核结果通知】

功能说明：

1.【企业会员实名开户】接口审核成功、审核失败，均发送通知；

2.云商通运营平台人工审核通过/审核不通过，均发送通知；

字段	字段类型	字段长度	必填	字段名称	说明
reqTraceNum	String		是	商户请求流水号	商户系统内保持唯一，定义长度为50位
signNum	String		是	商户会员编号
auditResult	String		是	审核结果：	2：审核成功。 3：审核失败。
auditTime	String		是	审核时间	格式：20240226170408
remark	String		否	人工审核备注
auditResultMsg	String		否	失败原因