测试地址:http://116.228.64.55:28082/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:注册证书(受益人)" 67:年报(受益人) 当“商户类型”字段选择“公司(不包含国有企业)”时,则“证明材料”字段不可上送“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:已受理 |
【企业会员支付账户开户审核状态通知】
接口说明:
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 |
否 |
通联单位支付账户服务协议 |