2.12【企业会员支付账户开户】

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

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

接口代码（transCode）：1025

功能说明：

支持未注册的会员，通过该接口上送资料并认证通过后，实现注册、设置角色、实名、生成支付账户号的流程；已注册（含未实名或已实名的情况）的会员，通过该接口补充资料后，实现实名、生成支付账户号的流程。
支持企业性质：企业、个体工商户、事业单位的企业会员实名，且仅支持个体工商户上送对私银行账户；
企业会员实名认证流程：按顺序触发-企业工商要素验证->法人实名认证->对公银行账户信息留存/对私银行账户认证：
均认证成功，即实名认证成功，会员状态=有效，
任一认证结果失败，即实名认证失败。
企业工商要素验证：企业名称，统一信用代码、法人名称；
法人认证要素：法人姓名，法人证件号、法人证件类型；
对私银行认证要素：法人名称、法人证件号、法人证件类型、银行卡号、预留手机号；
开户受理状态说明：
已受理：即本企业工商和法人信息已经验证通过，则响应“已受理”状态。
受理成功：即生成了待激活的支付账户号，生成待激活状态的支付账户后，可通过【会员线上协议签约】接口，签订支付账户开户协议，签约成功后由通联各事业部进行人工审核，审核结果通过【企业会员支付账户开户审核状态通知】通知。
受理失败：生成支付账户号失败。
测试环境渠道使用挡板测试，请用以下信息进行企业会员设置企业信息操作，以模拟识别成功结果：

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

认证类型：一证；

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

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

业务请求参数

字段	字段类型	字段长度	必填	字段名称	说明
reqTraceNum	String	50	是	请求流水号
signNum	String	60	是	商户会员编号	平台方开立支付账户，则上送#yunBizUserId_B2C#
memberRole	String	60	否	会员角色	（1）未注册，必须上送角色（2）已注册，无需上送，上送则需要与设置的角色一致角色枚举值：立即查看
enterpriseNature	String	1	否	企业性质： 1-企业 2-个体工商户 3-事业单位	不填，则默认“企业” 注：企业名称含“公司”，不支持上送“个体工商户”
notifyUrl	String	256	是	企业会员审核结果通知地址	如下情况，企业会员信息实名成功/失败均发送通知：（1）接口自动完成实名（2）运营平台人工审核后
enterpriseBaseInfo	JSONObject		是	企业基本信息	详细
legaAndBeneficiaryInfo	JSONObject		是	受益人信息	详细
bankAcctDetail	JSONObject		是	银行账户信息	详细
attachments	JSONObject		是	开户附件材料	详细

企业基本信息JSON（enterpriseBaseInfo）

字段	字段类型	必填	字段名称	说明
enterpriseName	String	否	企业名称	如有括号，用中文格式（）。已实名会员可不上送，以系统中数据为准
addressCode	String	否	地区码	见数据字段已实名会员可不上送，以系统中数据为准
enterpriseAdress	String	否	企业地址
unifiedSocialCredit	String	否	统一社会信用	已实名会员可不上送，以系统中数据为准
busLicenseValidate	String	是	营业证件有效期
legalPersonName	String	否	法人姓名	已实名会员可不上送，以系统中数据为准
legalPersonCerType	String	否	法人证件类型	仅支持身份证已实名会员可不上送，以系统中数据为准
legalPersonCerNum	String	否	法人证件号码	SM4加密已实名会员可不上送，以系统中数据为准
idValidateStart	String	是	法人证件有效开始日期	格式：2009-12-31
idValidateEnd	String	是	法人证件有效截止日期	格式：2009-12-31 若长期有效上送“9999-12-31”
legalPersonPhone	String	否	法人手机号码	已实名会员可不上送，以系统中数据为准
busiScope	String	是	经营内容	限制 50 个汉字以内

受益人信息JSON（legaAndBeneficiaryInfo）

字段	字段类型	必填	字段名称	说明
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”；
legalIsBeneficiary	String	是	法人是否受益人	0 是 1否
legalIsShareholder	String	是	法人是否为股东控制人	0 是 1否
beneficiaryCerType	String	是	受益人证件类型
beneficiaryName	String	是	受益人姓名
beneficiaryCerNum	String	是	受益人证件号码	SM4加密
beneficiaryCerValidate	String	是	受益人证件证件有效期
isSeniorManagement	String	是	是否为高管	0 否 1是
beneficiaryAddress	String	是	受益人住址
shareholderName	String	是	控股股东姓名
shareholderCerNum	String	是	控股股东证件号码	SM4加密
shareholderCerValidate	String	是	控股股东证件有效期

银行账户信息JSON（bankAcctDetail）

字段	字段类型	必填	字段名称	说明
acctAttr	String	否	账户类型	0：对私（银行账户名称默认为法人姓名） 1：对公（银行账户名称默认为企业名称）企业性质=企业/事业单位，默认1-对公，不支持上送0-对私；企业性质=个体工商户，支持上送0-对私/1-对公，不填默认1-对公；
acctNum	String	是	账号	对公户支持数字和“-”字符 SM4加密，详细已实名会员上送的银行账户需与本地该会员银行账户信息一致
bankReservePhone	String	否	银行预留手机	账户类型=0-对私时需要填写已实名会员可不上送，以系统中数据为准
openBankNo	String	否	银行代码	账户类型=1-对公时需要填写已实名会员可不上送，以系统中数据为准
openBankBranchName	String	否	开户行支行名称	如：“中国工商银行股份有限公司北京樱桃园支行” 账户类型=1-对公时需要填写已实名会员可不上送，以系统中数据为准
payBankNumber	String	否	支付行号，12位数字	账户类型=1-对公时需要填写已实名会员可不上送，以系统中数据为准
openBankProvince	String	是	开户行所在省	根据中国省市表的“省份”内容填写。详情账户类型=1-对公时需要填写已实名会员可不上送，以系统中数据为准
openBankCity	String	是	开户行所在市	根据中国省市表的“城市”内容填写。详情账户类型=1-对公时需要填写已实名会员可不上送，以系统中数据为准

开户附件材料（attachments）

字段	字段类型	必填	字段名称	说明
unifiedSocialCreditPhoto	String	否	统一信用证照片	已实名会员可不上送
legalNationalEmblemPhoto	String	否	法人证件（国徽面）	已实名会员可不上送
legalFacePhoto	String	否	法人证件（肖像面）	已实名会员可不上送
settleAcctPhoto	String	是	结算账户照
businessDoorHeadPhoto	String	是	经营门头照片
businessInteriorPhoto	String	是	经营内景照片
accountManagerWithDoorPhoto	String	是	客户经理与门头照
accountManagerHoldingIdCardPhoto	String	是	客户经理手持身份证照片
beneficiaryFile	String	否	受益所有人证明材料

业务响应参数

字段	字段类型	字段长度	必填	字段名称	取值
respTraceNum	String	40	否	响应流水号	业务正常处理，则返回
respCode	String	5	是	业务返回码	00000：代表成功 66666、66667：处理中，即当前的请求已受理，需要继续调用关联的确认类接口，或通过发起订单查询、等待异步通知，来获取处理状态。其他返回码：均代表失败
respMsg	String	200	否	业务返回说明
signNum	String	60	是	商户会员编号
openAcctStatus	String	1	否	开户受理状态	respCode为00000-交易成功时返回 0：已受理
openBankNo	String	8	否	银行代码	仅绑定对私卡时返回根据绑定的卡BIN识别对应银行代码字典
bankName	String	200	否	银行名称

【企业会员支付账户开户审核状态通知】

接口说明：

1.【企业会员支付账户开户】接口响应已受理后，通过该接口通知支付账户号、审核结果；

2.人工对企业会员支付账户开户审核后，就发送异步通知，审核通过/审核不通过，均发送通知。

3.支付账户状态从待激活变成正常时，通过该接口通知应用支付账户的启用情况。

4.开户受理状态说明：

受理成功：即生成了待激活的支付账户号，生成待激活状态的支付账户后，可通过【会员线上协议签约】接口，签订支付账户开户协议，签约成功后由通联各事业部进行人工审核，审核结果通过【企业会员支付账户开户审核状态通知】通知。
受理失败：生成支付账户号失败。

字段	字段类型	字段长度	必填	字段名称	说明
reqTraceNum	String	50	是	商户请求流水号	商户系统内保持唯一，定义长度为50位
respTraceNum	String	40	否	响应流水号
signNum	String	60	是	商户会员编号
openAcctStatus	String	1	是	开户受理状态	0：已受理 1：受理成功 2：受理失败
cusId	String	32	否	通联统一客户号
payAcctNo	String	15	否	支付账户号
payAcctNoStatus	String	1	否	支付账户状态	0：待激活 2：正常注：“待激活”状态可进行签约、打款验证，不可用于交易
respMsg	String	200	否	异常说明
payAcctAuditJson	JSONObject		否	支付账户审核结果详情	详细同【查询会员信息】中的“支付账户审核结果详情”

支付账户审核结果详情JSON（payAcctAuditJson）

字段	字段类型	必填	字段名称	说明
enterpriseVerifyResult	String	否	工商验证	0：无材料 1：待审核 2：系统验证通过 3：人工验证通过 4：系统验证不通过 5：人工验证不通过
legaIdCardVerifyResult	String	否	法人验证
bankAcctVerifyResult	String	否	银行结算账户验证
unifiedCreditPhotoResult	String	否	统一信用证照片验证
legalCerPhotoResult	String	否	法人证件照片验证
settleAcctPhotoResult	String	否	结算账户照
busOutdoorPhotoResult	String	否	经营门头照片
busInnerPhotoResult	String	否	经营内景照
acctManOutdoorPhotoResult	String	否	客户经理与门头照
acctManWithIdPhotoResult	String	否	客户经理手持身份证照片
busCoopConfirmResult	String	否	客户业务合作确认函
nonNatBenfitInfoResult	String	否	非自然人客户受益所有人信息登记表
tlPayAcctNoAgreeResult	String	否	通联单位支付账户服务协议