财付通一键绑卡接入流程与 FAQ

银行接入一键绑卡流程

一、 请先与网联调通：

网联接入模式下，银行需先按网联的技术方案接入，并与网联调通。

网联报文示例：

1<TrxInf>
2    <TrxCtgy>0287</TrxCtgy>
3    <TrxId>2020071500000000095754390302903</TrxId>
4    <TrxDtTm>2020-07-15T16:27:15</TrxDtTm>
5    <AuthMsg/>
6    <ClbckUrl>bind_scene%3DAPP_wx_delimiter_wx_http%3A%2F%2F172.16.1.190%3A8080%2Fmock%2Fchanne1%3F_channel%3D23DF</ClbckUrl>
7</TrxInf>

跳转场景:APP:跳转银行地址:http://172.16.1.190:8080/mock/channel?_channel=23DF_

财付通返回给网联报文示例

财付通对RdrctUrl是做了URL Encode，需要银行机构解码处理

1<MsgBody>
2    <SgnInf>
3        <SgnAcctIssrId>C1010611003601</SgnAcctIssrId>
4        <SgnAcctTp>01</SgnAcctTp>
5        <SgnAcctId>1vx12Kvi3tSFSSfRDf+6fQ==</SgnAcctId>
6        <SgnAcctNm>JNdvzcsJ6iSVIbocY3TKhQ==</SgnAcctNm>
7        <IDTp>01</IDTp>
8        <IDNO>BqHiiAn8bk1BjMoxpCsw4cbXvEbJxFL2GSgmQTn1awc=</IDNO>
9        <MobNo>qRBuuDNfqpdMNVx3ehimxQ==</MobNo>
10    </SgnInf>
11    <InstgInf>
12        <InstgId>Z2004944000010</InstgId>
13    </InstgInf>
14    <SysRtnInf>
15        <SysRtnCd>00000000</SysRtnCd>
16        <SysRtnDesc>成功</SysRtnDesc>
17        <SysRtnTm>2020-08-25T15:21:07</SysRtnTm>
18    </SysRtnInf>
19    <BizInf>
20        <BizStsCd>00000000</BizStsCd>
21        <BizStsDesc>成功</BizStsDesc>
22    </BizInf>
23    <OriTrxInf>
24        <TrxCtgy>0207</TrxCtgy>
25        <TrxId>2020082515220816967412871770101</TrxId>
26        <TrxDtTm>2028-08-25T15:22:08</TrxDtTm>
27    </OriTrxInf>
28    <RdrctUrl>
29        https%3A%2F%2Fpay.weixin.qq.com%2Fpaybind4h5%2Fnetsunion%2Fgetbindinfo%3Fsession_token%3D1qBc33bC1F2br%252FI7N7wKwWXKNqzB49dR%26from%3D2%23wechat_redirect
30    </RdrctUrl>
31</MsgBody>

跳转场量:H5,返回的地址是:https://pay.weixin.qq.com/paybind4h5/netsunion/getbindinfo?session_token=1qBc33bC1F2br%2FI7N7wKwWXKNqzB49dR&from=2#wechat_redirect

二、 签署协议，进行配置：

与财付通签署协议后，可提供相关信息给财付通，由财付通进行配置，每月集中配置一次。

提供的信息包括：银行全称、银行对外显示名称、接入渠道（网联）、接入卡类型（借记卡/信用卡）、接入场景（APP/公众号/线下智能设备/短信二维码等）、是否 需要绑卡成功后回跳、回跳地址（不同接入场景及手机系统分别的回跳地址）、是否需要对接测试环境（如果不需要，则直接配置到生产环境；如需要，会将生产环 境、测试环境均配置上）。

三、配置成功后，银行可进行测试验证。测试通过后可直接发布上线至生产环境，面 向用户使用。

银行接入一键绑卡 FAQ

Q：网联接入模式下，银行需要在测试环境进行测试，财付通侧怎么提供测试环境？

A：网联接入模式下，如银行对接财付通的线上环境，则默认对接财付通的线上环境；如银行对接财付通的测试环境，则默认对接财付通的测试环境。对接时，不需要做额外配置，只需要财付通在对应的网络环境下，配置银行一键绑卡权限。可在接入申请时确认是否需要对接测试环境，财付通开发按照运营提交的需求统一配置。

Q：各个场景怎么进入一键绑卡？

A：当前支持的场景包含线下智能设备（可使用二维码方案）、app、公众号、短信链接、二维码；暂不支持小程序，排期实现中。

银行接入一键绑卡后，可自行适配场景，实现一键绑卡。如是 app、公 众号、短信，则直接跳转获取的绑卡地址，如是二维码发起一键绑卡，则将获取 的绑卡地址生成二维码，一个二维码对应一个用户的一张银行卡。

Q：绑卡成功后有回调通知银行吗？

A：暂时没有绑卡成功回调通知。但绑卡成功后可以直接回到银行 app。

Q： 绑卡成功回到银行 app 一定要用户点击返回到银行吗？为啥不能直接回跳银行？

A：是的，这是财付通绑卡的统一流程。绑卡成功后先返回原生卡列表页，用户点击返回，再回到银行 app。

Q：为什么绑卡成功后不能回跳到银行？

A：请银行同学仔细检查自己提供的回跳地址。检查点 :

1）如果是直连模式，需确认当前返回地址是否跟当时接入财付通一键绑卡时，登记的返回地址一致，如果不一致，将导致财付通后台校验绑卡地址失败，不允许回跳。

2）回跳地址中不要带有原始的json参数，如必须有请自行encode，不然会导致财付通后台解码失败。

Q：跳转过程中，如何获取绑卡地址（也就是schema）

A：网联模式下，银行按照网联接口文档实现，即可获得一键绑卡转跳地址

Q：能否提供跳转链接的样例，想提前测试能否拉起微信

A：每次绑卡地址不一样，不是一个固定链接，没有样例格式为【weixin://dl/business/?ticket=xxx】ticket 后面的内容不同

Q：关于回跳地址的提供，可否有个简单说明，银行第一次提供资料的时候经常搞不清楚需要提供什么

A：银行提供一个后续想要跳回的页面地址即可，该地址会先在财付通登记，后续银行请求一键绑卡时，按接口文档带入该地址，如果财付通校验带入地址和预留地址一致，则用户点击返回，可跳回该地址。 如银行需要变更返回地址，需要将新地址提交，在财付通侧进行登记。

Q：跳转微信绑卡存在哪些异常，怎么展示

A：用户未下载微信，银行需要自行判断是否装载了微信客户端，如未装载，报错“请先安装微信后，再进行绑卡操作” 判断是否安装微信逻辑，可参考： https://developers.weixin.qq.com/doc/oplatform/Mobile_App/Resource_Center_Homepage.html

https://pay.weixin.qq.com/wiki/doc/api/app/app.php?chapter=8_5

其他异常，一键绑卡流程本身会进行报错处理

Q：如何实现营业厅智能终端，展示一键绑卡二维码，用户扫码可快速绑定的体验？

A：银行在知道用户身份信息+需要绑定的银行卡信息的情况下，可以按照一键绑卡开发文档发起绑卡请求，获得一键绑卡地址，并将该地址转化成二维码展示给用户，用户微信扫码后，即可拉起对应卡片的一键绑卡流程。 适用的场景包括新开卡用户在智能终端完成开卡后引导发起绑卡、用户在智能终端办理修改银行卡预留手机号等相关业务后引导发起绑卡。

Q：如果用户没有微信，怎么处理

A：银行直接报错即可。

Q：什么是回调？

A：指的是绑卡成功后通知银行的信息

Q：什么是回跳？

A：指的是绑卡成功后跳转到哪个页面，目前支持：

（1）APP-跳转银行 APP

（2）H5-跳转 H5 页面

跳转地址需整体URLEncode（编码：UTF-8）

Q：不回调微信测还是会显示绑卡成功对吗？

A：对