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


测试地址: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:注册证书(受益人)"
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:已受理

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

接口说明:

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

通联单位支付账户服务协议


maxy2 2025年4月14日 10:25 收藏文档