接入前准备
更新时间：2024.12.27# 获取银行Key
为不影响联调进度，各家银行在联调前至少三周按以下模板发送邮件并抄送对接BD，获取正式环境key&测试环境key
注意
如果银行是在生产环境测试，则只需申请生产环境key；如果银行是在测试环境测试，则需申请生产环境Key&测试环境Key
测试环境的联调测试指引见：《免输卡号绑卡测试指引》 (opens new window)
# 小程序形式接入
# 小程序形式接入邮件模板
邮件名：【XX银行借记卡/贷记卡/双卡】免输卡号绑卡联调申请——请提供对应银行的key
收件人： jeremyzhai@tencent.com
抄送人： oscarbwang@tencent.com; iceyyyang@tencent.com; aliciahan@tencent.com
邮件内容：
辛苦处理，并将配置好的key回复邮件，感谢！
生产环境相关信息如下：
- 生产环境AppID 及对应的原始ID（获取途径：首先登录微信公众号，在左侧导航栏中找到公众号设置，点进去就能看到公众号的详细信息，获取办法。）
- 小程序name （说明：类似这种格式：gh_XXXXXXXXXXX@app，就是小程序的原始ID，银行可以在开平的后台查到，gh开头的）
- 小程序path （说明：此为银行自己的小程序路径）
测试环境相关信息如下：
- 测试环境AppID 及对应的原始ID（获取途径：首先登录微信公众号，在左侧导航栏中找到公众号设置，点进去就能看到公众号的详细信息，获取办法。）
- 小程序name （说明：类似这种格式：gh_XXXXXXXXXXX@app，就是小程序的原始ID，银行可以在开平的后台查到，gh开头的）
- 小程序path （说明：此为银行自己的小程序路径）
提示
测试环境测试需提供银行主体下的AppID进行配置，如果直接在生产环境验证，只提供生产环境的配置信息即可。
-----------------以下“1.2. 公众号H5形式接入” 对于新接入银行已不再使用--------------------
在2022.08.15之前，如果银行已经发送申请邮件，可继续按公众号H5形式接入配置。
如为新接银行，请以小程序形式接入，并以“1.1 小程序形式接入”邮件模板为准。
# 公众号H5形式接入
请银行确认与微信联调的环境为银行生产环境还是银行测试环境，并根据下列要求发送邮件
# 公众号H5形式接入邮件模板
邮件名：【XX银行借记卡/贷记卡/双卡】免输卡号绑卡联调申请——请提供对应银行的key
收件人：jeremyzhai@tencent.com
抄送人：oscarbwang@tencent.com; iceyyyang@tencent.com; aliciahan@tencent.com
邮件内容：
辛苦处理，并将配置好的key回复邮件，感谢：）
生产环境相关信息如下：
- AppID 及对应的原始ID（获取途径：首先登录微信公众号，在左侧导航栏中找到公众号设置，点进去就能看到公众号的详细信息。若银行接入免输卡号的页面形式为H5，需要该银行公众号的AppID）
- 生产环境H5链接（说明：此为从微信侧跳转到银行的链接，需使用标准端口链接）
测试环境相关信息如下：
- AppID 及对应的原始ID（获取途径：首先登录微信公众号，在左侧导航栏中找到公众号设置，点进去就能看到公众号的详细信息。若银行接入免输卡号的页面形式为H5，需要该银行公众号的AppID）
- 测试环境H5链接（说明：此为从微信侧跳转到银行的链接，需使用标准端口链接）
注意：测试环境测试需提供银行主体下的AppID进行配置，如果直接在生产环境验证，只提供生产环境的配置信息即可
# 获取身份信息生产环境密钥
身份信息生产环境密钥需要银行在联调前至少三周邮件申请
身份信息的密钥，测试环境可以直接使用财付通密钥，生产环境中银行需要提供公钥给财付通配置，财付通会用银行公钥进行身份信息加密。
测试环境密钥见《财付通免输卡号绑卡测试秘钥》 (opens new window)，生产环境密钥格式保持一致即可
测试环境的密钥统一使用财付通提供的，生产环境公钥由银行自行提供。
邮件模板：
邮件名：【XX银行借记卡/贷记卡/双卡】免输卡号绑卡生产密钥
收件人： carterche@tencent.com
抄送人： oscarbwang@tencent.com; iceyyyang@tencent.com; aliciahan@tencent.com; ronrainli@tencent.com; v_wenziwei@tencent.com
邮件内容：
以下附件为银行公钥信息，请财付通同事配置生产密钥，谢谢！
附件提供：
公钥文件.pem（文件格式为pem，不要用cer/txt）
注意
- 财付通需要公钥格式：2048位PKCS#8格式的rsa公钥
- 生产密钥请银行在确认后及时发送给财付通（开发环节确认后即可），财付通生产密钥配置通常需要2-3周，请在联调前至少3周进行邮件申请。
- 建议银行侧直接上生产环境与微信支付进行联调测试，微信侧会控制入口保证用户不可见此功能。
# 银行白名单配置（微信号）
需要银行在联调前至少两周邮件申请银行白名单配置，用于上线前的验证或生产环境测试。（测试环境使用的是测试账号，银行上线进入生产环境后，使用真实微信号进行验证，故需申请配置白名单。）
邮件模板：
邮件名：【XX银行借记卡/贷记卡/双卡】免输卡号绑卡联调申请——请配置银行白名单
收件人： jeremyzhai@tencent.com
抄送人： oscarbwang@tencent.com; iceyyyang@tencent.com; aliciahan@tencent.com
邮件内容： 白名单见附件，个数共计XX个。
（请附上银行白名单excel文件，格式为微信号，一行一个微信号，数量不超过10个，用于联调时的测试及流程体验）
提示
白名单用户建议包含使用ios和安卓的微信用户，如果银行接入的卡类型为双卡种，则ios与安卓的微信用户也需要覆盖到双卡种。鉴于生产验收需要多卡种【无卡可绑】情况的录屏，银行需注意添加无卡用户用于验证。已配置白名单的银行不支持新增用户。
# 开发联调上线全流程
免输卡号支持两种环境检验，分别是生产环境与测试环境，一般银行先在测试环境测好后，再上线到生产环境进行测试，整体流程如下：
银行开发（微信支付小助手+FIT答疑）→联调前两周银行发邮件申请微信支付key（微信支付生产环境key&测试环境key均需要、财付通生产密钥配置、银行白名单配置（10个以内）→测试环境验证→视觉走查→银行投产→生产环境验证→生产录屏检查→微信支付灰度发布（10%、40%、70%、全量）
微信支付灰度发布预计两周完成，每灰度一个阶段，观察无问题后再继续扩大灰度范围。
提示
因视觉走查耗时较久，建议银行侧开发完成内部测试无问题后就请微信支付侧视觉设计师进行视觉走查，视觉走查内容见此文档的第五部分内容《前端设计验收》
