一网通账户

站外签约商户开户开发指南

一、接入方式

站外开户带签约包的地址:

 测试环境: https://paytest.cmburl.cn/IGateway/Jump.aspx?funcid=00161070&CorperationCode=XXXXXX&......

 生产环境:https://html.m.cmbchina.com/Igateway/jump.aspx?funcid=00161070&CorperationCode=XXXXXX&......

字段名
字段描述备注
CorperationCode合作方编码有接入开户场景必须上传合作编码,否则将报错。合作编码申请请联系徐颖必输
jsonRequestData签约包内容json格式的签约包,具体请参见 商户签约API


二、功能简述:

该接口用于开立一网通帐户及签约,一网通帐户包括II类户、III类户,签约包括一网通支付、一网通免密支付、系统代发等。

约束条件:

短信验证码6分钟内有效
合作方保存协议号agrNo,并保证其唯一性。

正常流程

  1. 合作方传递请求包给招商银行H5页面。

  2. 持卡人在招商银行H5页面填写开户信息包括:姓名+证件号+银行卡+手机号+验证码+登录密码+支付密码+身份证件;

  3. 在开II类户时,可能触发风控,需要人脸识别

  4. 招行系统后台为其开通一网通帐户并签约,并发送签约成功回调通知给合作方(参考3.8节);

  5. 用户收到成功开通一网通帐户的短信通知


异常流程

  1. 签约包发送失败。请合作方联调时传递姓名、身份证参数,若签约包成功发送,招行页面会回显姓名及身份证,若无回显则说明签约包没有正常传递。

  2. 签约包校验异常,请参考错误码

  3. H5页面中出现报错,请合作方联系一网通支持小组协助解决


三、应用场景

例1------宁波驾培服务,站外签约商户开户

  • 场景说明:站外签约商户签约开户完成后,用开通账户做培训费用支付

  • 申请合作方编码:配置成2类户用户费用支付

  • 去商户管理平台配置商户资料:加密和签名使用,中间业务平台签约使用

  • 跳转链接:https://html.m.cmbchina.com/Igateway/jump.aspx?funcid=0161070&CorperationCode=Z00001NLB2fhhz0000000000NBJPFW&jsonRequestData=XXXXXXXXXXXXXX

  • 说明:签约包生成规则见API文档