1、名词解释

2、业务背景

为解决用户忘记卡号，卡不在身边也能绑卡，进一步提升用户快捷支付绑卡随绑随付的便利性，降低因签约信息误填、弃填等问题出现的频率，提高签约成功率，优化客户签约体验以及提升用户信息安全。支付宝基于网联平台报文交互规范，定义了一套快捷绑卡2.0解决方案及标准业务流程，帮助各发卡银行快速完成系统升级和对接。

3、业务流程

用户在支付宝APP打开“添加银行卡”功能，选择发卡银行以及对应卡类型，在完成用户支付宝侧身份信息验证后（如支付密码、指纹或人脸识别），页面跳转至银行绑卡验证H5页面，用户在银行页面完成授权、选卡（如有多张卡）以及短信验证后，后台系统完成快捷协议签约，页面跳回支付宝并提示用户绑定成功。

网关签约业务流程根据服务提供方可分为两个阶段，第一阶段由支付宝进行用户身份验证，成功后跳转至银行页面；第二阶段由银行页面提供用户授权、选卡、绑卡服务，绑卡完成后跳回支付宝页面展示结果。若银行处理绑卡失败，也回跳支付宝页面展示失败信息并提示用户做相应处理。

不同银行业务处理流程有所不同，因此阶段二也分为“先验证授权后选卡”以及“先选卡后验证授权”两种流程。在用户选卡并确认信息后，绑卡提交前（即最后一步前）进行短信验证有助于进一步提升绑卡业务成功率，建议银行采用“先选卡后验证授权”的业务流程。本方案后续以该推荐流程介绍后续技术集成方案。

4、准备工作

合作流程

为帮助银行详细了解整体合作对接流程，下图详细描述了银行侧以及支付宝侧的工作内容以及对应步骤。其中红色节点为银行操作，蓝色节点为支付宝操作。

同网联侧对接

1. 银行同网联完成业务签约（以网联侧业务流程为准），获取到在网联平台使用的账户机构14位“金融机构编码”。
2. 银行已获取网联侧提供的测试环境、测试账号等信息。

同支付宝侧对接

1. 银行需注册并提供支付宝账号，与支付宝BD签订“快捷2.0-网关签约协议”；
2. 提供在网联平台使用的账户机构14位“金融机构编码”以供支付宝配置支持该行绑卡。
3. 银行需提供行方开发测试人员支付宝账号uid，用以配置白名单（白名单用户可看到对应银行卡绑卡入口，获取uid方法参考如下）
4. 银行需提供https域名用于生产运行，支付宝APP绑卡不支持非安全地址。

研发加速服务

1. 支付宝针对网关签约页面设计了一套前端交互规范，建议作为银行业务流程的参考模板。（点此下载交互规范）
2. 基于上述交互规范和样式，支付宝提供了一套前端技术组件库，方便银行快速进行页面开发。银行可基于该组件或其源码进行二次开发，构建满足自身业务需求的网关签约交互页面。（点此访问UI组件库） 
3. 支付宝提供机构服务平台，用于协助银行快速网关联调。测试平台地址及帮助文档点此访问。

5、技术方案

快捷支付2.0网关签约业务除了前面介绍的页面流程外，在后端系统接口交互层面主要由银行直接对接网联平台，并经由网联平台间接对接支付宝。完整报文交互流程如下。银行侧开发工作分为“银行服务端”和“银行前端”（H5或小程序）两部分。下面就银行在整体技术链路中涉及的主要工作进行说明。

银行服务端工作

银行服务端除自身业务功能开发外，需处理支付宝APP跳转银行侧的信息（步骤1.3和1.3.1），并且在绑卡完成后回跳支付宝，并通过网联平台返回快捷协议号（步骤3.1.2和3.2），或在失败情况下返回对应错误码和错误描述信息，并最终返回支付宝页面进行结果展示（绑卡成功或失败，以及失败原因和推荐处理措施）。

银行前端工作

银行前端开发主要涉及与银行服务端内部交互，以及最终回跳支付宝APP页面，银行前端页面需按照交互规范，为用户提供清晰动线，并需保证每次页面跳转耗时小于3秒的技术指标。

处理支付宝跳转信息

支付宝获取到网联平台返回的银行绑卡页面地址后（步骤1.2），会通过POST方法，进行如下内容的表单提交，其中表单字段名为epccGwMsg，字段值为基于网联快捷协议签约跳转报文（epcc.105.001.01）返回的加密信息Sec的base64编码。

由于表单提交会进行URLEncode，因此银行网关接收到请求信息后需先进行URLDecode解码，然后进行base64解码以获取原始加密信息Sec，并用于后续解密处理。由于某些银行系统内部会自动进行URLDecode，因此需保证系统不会进行多次url解码。

绑卡结束回跳支付宝

绑卡结束回跳支付宝分为服务端信息回执以及页面端地址回跳，其中服务端信息回执不涉及页面交互，由银行通过网联平台向支付宝服务端返回绑卡结果。具体银行需发送快捷协议签约回执报文（epcc.102.001.01，交易类别0200），并填写快捷协议号SgnNo等信息，通知网联及支付宝绑卡成功。对于绑卡失败场景，银行需按网联平台规范给出对应错误码和错误描述，保证用户可知晓绑卡失败的原因，减少用户因不清楚具体失败原因而导致的咨询或投诉。

页面端回跳支付宝的地址可通过解密上述加密信息Sec获取，字段名为ClbckUrl，目前支付宝回跳地址为支付宝APP内使用的固定内部地址，形式如https://sdklite.h5quit，银行在完成绑卡后，无论成功失败，均可直接回跳上述地址，支付宝会内部进行绑卡状态查询和页面展示。银行回跳方式为直接GET请求该地址，并且无需携带任何附加参数和信息，代码示例如下：window.location.href="https://sdklite.h5quit"。由于是支付宝APP内部地址，因此银行需进行相关访问域名白名单添加（如银行有域名访问控制），允许上述地址的回跳而无需检查地址的格式或有效性。

6、请求参数示例

处理支付宝跳转信息场景

此处银行服务端被动接收支付宝请求，无主动请求报文。银行监听支付宝请求后，通过url解码以及base64解码获取快捷协议签约跳转报文（epcc.105.001.01）的加密信息Sec，经过解密后可获取支付宝提供的受理人相关信息以及回跳支付宝的地址ClbckUrl。解密规范参见网联平台文档说明。

绑卡结束回跳支付宝场景

银行绑卡成功或出现错误后需发送快捷协议签约回执报文（epcc.102.001.01，交易类别0200）

绑卡成功

绑卡出错

todo

7、相关API列表

接口API由网联平台定义，具体文档请咨询网联并由网联平台官方提供。

1. 网联平台-快捷协议签约跳转报文（epcc.105.001.01）
2. 网联平台-快捷协议签约回执报文（epcc.102.001.01）

8、上线前准备

正式业务上线前，双方需完成如下三阶段测试及验收。

1. 测试环境调通（银行测试环境+网联测试环境+支付宝测试环境）。银行主要在该环境下进行开发和测试，以银行自测为主，完成银行内部的开发环境测试验收流程。
2. 验收测试（银行测试环境+网联测试环境+支付宝预发布环境【白名单控制】）。第一阶段银行开发测试完成后，支付宝通过配置银行卡入口，以及银行测试人员可见，由银行测试人员进行全流程录屏测试。录屏要求和规范参见下面的“验收样例”。
3. 线上业务验收（银行生产环境+网联生产环境+支付宝生产环境）。第二阶段验收测试通过后，银行和支付宝双方即可进行生产上线，上线后银行需进行生产环境的业务验收测试，以保证线上真实可用。

下面就阶段二“验收测试”进行详细说明。

验收测试前准备工作

1. 银行已完成开发环境联调和测试，即已完成上述阶段一。
2. 支付宝已完成预发布环境服务端发布（系统支持该发卡行绑卡）。
3. 银行已提供测试人员uid，并由支付宝完成白名单添加（白名单用户可看到绑卡入口，获取uid方法参考如下）。

业务验收原则

支付宝会基于如下原则对系统和用户交互流程进行评估，以保证整体用户交互和体验达到最佳，请银行产研人员进行关注，其中红线问题无法通过业务验收。

1. 【红线问题】用户有该行银行卡的情况下，且选择卡类型正确，无法绑卡成功。
2. 【红线问题】用户无该行银行卡的情况下，返回信息不明确。
3. 卡列表仅展示可绑定的卡（外卡、注销卡等不能签约快捷协议的卡，不对用户展示）。
4. 所有页面打开耗时需小于等于3秒（保证用户体验）。
5. 无论最终绑卡成功还是失败，银行需跳回支付宝页面并展示对应结果（绑卡成功或具体失败原因及推荐解决方案）。
6. 不同版本客户端（iOS、Android）和不同屏幕需正常显示和处理（防止小屏显示不全、页面错乱等问题）。
7. 为保证用户体验，首次短信验证码自动触发，并且验证码键盘为最适合的类型（如验证码仅有数字，建议使用纯数字键盘）。

验收样例

支付宝侧业务验收需银行提供完整录屏，涉及Android以及iOS双端，包含一个单卡成功场景（样例1或2），一个多卡成功场景（样例3或4），以及一个无卡失败场景（样例9或10），总计6个完整流程录屏。录屏文件命名如下：

1. Android单卡成功.mp4
2. Android多卡成功.mp4
3. Android无卡失败.mp4
4. iOS单卡成功.mp4
5. iOS多卡成功.mp4
6. iOS无卡失败.mp4

银行侧业务验收可内部进行更为详细的验收样例测试，可基于下面10种测试场景进行扩展，以提升系统的健壮性、稳定性和用户体验。

1. （单卡成功场景）用户仅有一张该行储蓄卡的情况下，且选择卡类型正确，成功绑定该储蓄卡。
2. （单卡成功场景）用户仅有一张该行信用卡的情况下，且选择卡类型正确，成功绑定该信用卡。
3. （多卡成功场景）用户有多张该行储蓄卡的情况下，且选择卡类型正确，页面可展示多张可用储蓄卡，且可成功绑定所选择的储蓄卡。
4. （多卡成功场景）用户有多张该行信用卡的情况下，且选择卡类型正确，页面可展示多张可用信用卡，且可成功绑定所选择的信用卡。
5. （单卡失败场景）用户仅有一张该行储蓄卡的情况下，且未选择正确的卡类型，返回无可用卡绑定。
6. （单卡失败场景）用户仅有一张该行信用卡的情况下，且未选择正确的卡类型，返回无可用卡绑定。
7. （多卡失败场景）用户有多张该行储蓄卡的情况下，且未选择正确的卡类型，返回无可用卡绑定。
8. （多卡失败场景）用户有多张该行信用卡的情况下，且未选择正确的卡类型，返回无可用卡绑定。
9. （无卡失败场景）用户无该行卡的情况下，选择储蓄卡进行绑定，返回无可用卡绑定。
10. （无卡失败场景）用户无该行卡的情况下，选择信用卡进行绑定，返回无可用卡绑定。

9、附录

1、支付宝扫码获取支付宝uid

2、支持的证件类型

FAQ