测试地址:http://116.228.64.55:28082/yst-service-api/tm/handle
生产地址:https://ibsapi.allinpay.com/yst-service-api/tm/handle
接口代码(transCode):1029
功能说明:
- 前提:仅支持个人会员,且需先调用【会员实名绑卡申请】接口完成实名。
- 本接口向客户响应通联的支付账户开户H5,可在通联的页面上依次完成:绑定手机号、上传影印件、补全个人信息、开户协议签约的流程。任一环节未通过,无法开通个人支付账户。
- 本H5页面支持在小程序环境打开。
- 页面支持断点继续操作。
- 若已通过【会员绑定手机号】或静默绑定手机号,即已完成手机号绑定,则开户H5页面会跳过绑定手机号流程,进入下一环节。
- 提交至最后一步开户后,发送【个人支付账户开户结果通知】。
- 上送业务请求参数后,请求成功后,接口通过业务响应参数同步响应个人支付账户开户H5页面链接,请于H5或者小程序环境打开此链接。
- 经个人支付账户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页面 |
【个人支付账户开户结果通知】
功能说明:
- 【个人支付账户开户H5】页面操作完成后,通过该接口通知支付账户号、开户结果;
- 支付协议签约成功,通过认证渠道数校验,并开立支付账户号,就发送异步通知。
- 支付账户状态设置为正常,通过该接口通知应用支付账户的启用情况。
- 支付账户账号需要落到【会员账户信息管理】和【个人账户额度使用查询】两个菜单中去。
业务响应参数
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
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 |
否 |
失败说明 |