一网通绑卡(实名认证)接口

本文档提供了跳转绑卡流程的方法说明。

在使用该接口前,请先阅读“应用场景介绍”。

应用场景介绍

如果当前的功能需要实名认证后的客户才能使用,那么,可以引导尚未实名的客户去绑卡,绑卡成功即完成实名认证,绑卡完成后再回到跳入绑卡的页面进行下一步造作。

备注:由业务方根据自身的业务需要,自行决定是否要求客户进行实名。为了提升客户体验,如果有仅限实名用户使用的功能,需要在提示用户需要实名认证,并提供引导到实名认证流程的入口。

未实名用户的判定方法:“用户登录与授权”接口只返回ExpandUserID字段,无NewUserIDUniqueUserID字段信息的,即为未实名客户;


接口说明

接口地址

http://cmbls/functionjump?action=gofuncid&funcid=400015&clean=true&cmb_app_trans_parms_start=here&Data=****&fromfunc=****

ST/UAT/生产环境均用此地址)


参数定义及参数说明

参数名参数释义备注
funcid

绑卡的跳转functionid,确定跳转的是绑定银行卡页面

直接使用funcid=400015的固定值




clean
true代表关闭当前窗口,直接打开绑卡页面窗口;false代表保留当前窗口,并且在原窗口上面打开一个新窗口

data

如果需要支持绑卡完成或者中途返回,则需要传该参数,该参数的值可以为随机hash

当该参数有值时,clean参数值需要是false


fromfunc

必选,确定是从哪个业务跳转绑卡的,使用英文命名业务功能

行外调用方可以自行定义fromfunc


其他注意事项

1、绑卡支持返回,但是只是返回到跳入绑卡的界面,无法通知绑卡成功或者失败,如果业务功能需要知道绑卡的情况,需要重新获取下手机银行登录令牌(如果登录接口返回的字段同时包括ExpandUserID和NewUserID则代表客户已经绑卡成功),或者自己主动去获取卡列表。

跳入绑卡的页面可以自己监听曝光事件(visibilitychange事件)并刷新。

2、如无法实现上一点,建议跳转绑卡的参数clean=true,这样的缺点是无法回到之前的业务功能。