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


测试地址:http://116.228.64.55:28082/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

失败说明

 

maxy2 2025年2月21日 16:09 收藏文档