2.2【企业会员实名开户】

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

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

接口代码（transCode）：1020

功能说明：

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

2、支持未注册或会员状态=待生效、审核失败的企业会员进行实名，实名认证通过，开立簿记账户。

3、企业会员实名认证流程：按顺序触发-企业工商要素验证->法人实名认证->对公银行账户信息留存/对私银行账户认证：三个认证环节，无论上一环节是否认证成功，下一环节均发送渠道认证，并在运营平台【企业基本信息】记录信息及认证结果信息；

企业工商要素验证：企业名称，统一信用代码、法人名称；
法人认证要素：法人姓名，法人证件号、法人证件类型；
对私银行认证要素：法人名称、法人证件号、法人证件类型、银行卡号、预留手机号；

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

认证结果处理逻辑：

（1）均认证成功，即实名认证成功，会员状态=有效；

（2）任一认证结果失败，即实名认证失败，会员状态=审核失败，支持通过此接口重新实名。

（3）针对法人非身份证证件类型，若“企业工商要素认证成功+银行账户认证成功”，则接口响应“审核成功”；若认证失败，则接口响应“审核失败”（会员状态=审核失败），“失败原因”提示“法人证件类型非身份证类型，需人工审核”；商户继续上传影印件，走运营平台人工审核流程，审核通过，则会员状态=“有效”。

（4）针对个体工商且营业证件名称为“*”或者是空的情况，企业工商要素验证时，仅比对证件号、法人信息，验证通过后系统自动将“会员名称”置为“个体户+法人姓名”的格式，如“个体户张三”，不取接口上送的企业名称。

4.因测试环境渠道使用挡板测试，请用以下信息进行企业会员设置企业信息操作，以模拟识别成功结果：

企业名称：竹溪县子怡鞋店；

认证类型：一证；

统一社会信用代码：92420324MA4D68J28J；

法人姓名：王三华；法人证件类型：身份证，法人证件号码：51370119380325580X；

上传影印件进行识别时，可ocr识别通过的影印件如下：[附件]测试环境ocr证件照片.zip

5、会员实名开户个数风控：

手机号限制数量

营业证件限制数量

身份证限制数量

3

（注：企业法人注册个人会员时，则该证件号的个人会员数+企业会员数=3）

业务请求参数

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

企业基本信息JSON（enterpriseBaseInfo）

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

银行账户信息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	是	开户行所在市	开户行所在市开户行所在省必须同时上送根据中国省市表的“城市”内容填写，中文

响应报文参数

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

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

功能说明：

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

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

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