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

测试地址：http://116.228.64.55:28082/yst-service-api/tm/handle

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

接口代码（transCode）：1020

功能说明：

1、支持企业性质：企业、个体工商户、事业单位的企业会员实名开户，对于个体工商户支持绑定对私银行账户；

2、支持未注册或会员状态=银行审核失败、审核失败的企业会员进行实名，实名认证（或人工审核）通过，开通银行子账户。

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

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

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

中信托管：

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

华通托管：

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

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

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

处理逻辑：

（1）企业会员申请实名开户，则【企业会员管理】菜单落地企业会员信息；

（2）【银行子账户信息管理】菜单管理会员及银行子账户开户信息；

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

业务请求参数

字段	字段类型	字段长度	必填	字段名称	说明
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	是	法人手机号码	注意：此手机号在绑定手机时会进行法人运营商三要素验证。
legpCerFrontFileId	String	否	法人身份证（肖像面）token	通过【文件上传下载接口】上传文件图片后获取的fileId，有效期30分钟，图片不超过2M 法人身份证证件类型：肖像面和国徽面必须同时上传。法人非身份证证件类型：仅上传“法人身份证（肖像面）token”即可。华通银行，必填
legpCerBackFileId	String	否	法人身份证（国徽面）token
unifiedSocialCreditFileId	String	否	统一信用证token

银行账户信息JSON(bankAcctDetail)

字段	字段类型	必填	字段名称	说明
acctAttr	String	否	账户类型	对私（银行账户名称默认为法人姓名）对公（银行账户名称默认为企业名称）企业性质=企业/事业单位，默认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	是	开户行所在市	开户行所在市开户行所在省必须同时上送根据中国省市表的“城市”内容填写。

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

字段	字段类型	必填	字段名称	说明
enterpriseScale	String	否	企业规模	针对华通银行（企业性质），必填详情
enterpriseType	String	否	企业类型	针对华通银行（企业性质），必填详情
economicNature	String	否	企业经济性质	针对华通银行（企业性质），必填详情
country	String	否	国籍	针对华通银行，必填详情
regCapital	String	否	企业注册资本单位：元	针对华通银行（企业性质），必填
occupation	String	否	行业说明：个体工商户，上送职业枚举值	针对华通银行，必填详情
businessBeginDate	String	否	公司经营开始时间格式：yyyy-MM-dd	针对华通银行（企业性质），必填
businessEndDate	String	否	公司经营结束日期格式：yyyy-MM-dd	针对华通银行（企业性质），必填
contactMobile	String	否	企业联系人手机号	针对华通银行（企业性质），必填
linkAddresscode	String	否	经营地址省市区/企业联系地址所在省市区，地区码	针对华通银行（企业性质），必填
enterpriseAddress	String	否	经营详细地址/企业联系地址	针对华通银行（企业性质），必填
businessScope	String	否	经营范围	针对华通银行（企业性质），选填
openLicenseCode	String	否	开户许可证核准号或基本存款账户编号	针对华通银行（企业性质），选填
openLicenseToken	String	否	开户许可证文件	针对华通银行（企业性质），选填
shareholderInfo	JSONObect	否	控股股东/实际控制人	针对华通银行（企业性质），必填
beneficiaryInfo	JSONObect	否	受益所有人信息	针对华通银行（企业性质），必填

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

字段	字段类型	必填	字段名称	说明
shareholderName	String	否	控股股东/实际控制人名称
shareholderCertType	String	否	控股股东/实际控制人证件类型
shareholderCertNo	String	否	控股股东/实际控制人证件号	无需加密，明文
shareholderCertBeginDate	String	否	控股股东/实际控制人证件开始日期
shareholderCertEndDate	String	否	控股股东/实际控制人证件截止日期
shareholderPhone	String	否	股东或实际控制人电话

新增【受益所有人】对象

字段	字段类型	必填	字段名称	说明
beneficiaryName	String	否	受益所有人名称
beneficiaryAddress	String	否	受益所有人地址
beneficiaryPhone	String	否	受益所有人电话
beneficiaryIdType	String	否	受益所有人证件类型
beneficiaryIdNo	String	否	受益所有人证件号码	无需加密，明文
beneficiaryIdEffDate	String	否	受益所有人证件开始日期	格式：YYYY-MM-dd
beneficiaryIdOffDate	String	否	受益所有人证件到期日期

响应请求参数

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

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

功能说明：

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

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

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