2.22 【个人支付账户开户H5】


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

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

接口代码(transCode):1029

功能说明:

  1. 前提:仅支持个人会员,且需先调用【会员实名绑卡申请】接口完成实名。
  2. 本接口向客户响应通联的支付账户开户H5,可在通联的页面上依次完成:绑定手机号、上传影印件、补全个人信息、开户协议签约的流程。任一环节未通过,无法开通个人支付账户。
  3. 本H5页面支持在小程序环境打开。
  4. 页面支持断点继续操作。
  5. 若已通过【会员绑定手机号】或静默绑定手机号,即已完成手机号绑定,则开户H5页面会跳过绑定手机号流程,进入下一环节。
  6. 提交至最后一步开户后,发送【个人支付账户开户结果通知】。
  7. 上送业务请求参数后,请求成功后,接口通过业务响应参数同步响应个人支付账户开户H5页面链接,请于H5或者小程序环境打开此链接。
  8. 经个人支付账户H5页面开户成功后,会跳转至开户结果页面,具体情况会经【个人支付账户开户结果通知】接口通知至个人会员支付账户开户结果通知地址。

业务请求参数

字段

字段类型

字段长度

必填

字段名称

说明

reqTraceNum

String

50

是

请求流水号

 

signNum

String

60

是

商户会员编号

 

notifyUrl

String

256

是

个人会员支付账户开户结果通知地址

 

jumpUrl

String

256

否

前端回调地址

H5开户流程结束后应跳转回的页面地址

业务响应参数

字段

字段类型

字段长度

必填

字段名称

取值

respTraceNum

String

40

否

响应流水号

业务正常处理,则返回

respCode

String

5

是

业务返回码

00000:代表成功

66666、66667:处理中,即当前的请求已受理,需要继续调用关联的确认类接口,或通过发起订单查询、等待异步通知,来获取处理状态。

其他返回码:均代表失败

 

respMsg

String

200

否

业务返回说明

 

signNum

String

60

是

商户会员编号

 

openAcctStatus

String

1

否

开户受理状态

respCode为00000-交易成功时返回0:已受理。

0:已受理

1:受理成功

2:受理失败

openAcctUrl

String

500

否

个人支付账户开户H5—url

用户请求成功后,通过此链接可以跳转到个人支付账户开户H5页面

 

【个人支付账户开户结果通知】

功能说明:

  1. 【个人支付账户开户H5】页面操作完成后,通过该接口通知支付账户号、开户结果;
  2. 支付协议签约成功,通过认证渠道数校验,并开立支付账户号,就发送异步通知。
  3. 支付账户状态设置为正常,通过该接口通知应用支付账户的启用情况。
  4. 支付账户账号需要落到【会员账户信息管理】和【个人账户额度使用查询】两个菜单中去。

业务响应参数

字段

字段类型

字段长度

必填

字段名称

说明

reqTraceNum

String

50

是

商户请求流水号

商户系统内保持唯一,定义长度为50位

respTraceNum

String

40

否

响应流水号

 

signNum

String

60

是

商户会员编号

 

openAccoutResult

String

1

是

支付账户开户结果

0:开户成功

1:开户失败

payAcctNo

String

15

否

支付账户号

 

payAcctNoStatus

String

1

否

支付账户状态

2:正常

由于个人支付账户开通流程不需要审核,因此,只要是受理成功(成功开通),支付账户状态就为正常。

payAcctType

String

1

否

支付账户分类

1:1类

2:2类

3:3类

respMsg

String

200

否

失败说明

 

2025年11月25日 19:54 收藏文档