为了确保商家在转换新旧平台证书过程中能够顺利且高效,微信支付特别为商家打造了一套平台证书更换的工具。本文旨在向商户开发者详细讲解如何运用这一工具,成功实现新旧证书的替换过程。
商户开发者需认真阅读相关内容,以便充分掌握平台证书的核心定义及其更换流程,同时依据指导原则,确保商户系统能够顺利完成平台证书的获取、应用、部署以及更新等核心操作。
在进行所有操作时,务必在贵公司技术人员的专业指导下进行。首先,需将技术人员设定为安全联系人,具体配置步骤可参照相关说明。
已支持多证书验签的商户
一旦商户系统成功获取并实施了新旧证书,并且能够依据微信支付API的应答或通知回调中的HTTP头部信息,选择恰当的平台证书进行验证签名,那么请按照以下指引逐步进行平台证书的灰度替换。
步骤一:登录商户平台,进入平台证书管理
请参照以下步骤操作:首先,查看图片指示;其次,登录至微信支付商户平台;接着,导航至【账户中心】;然后,选择【API安全】下的【平台证书】;最后,点击“管理证书”按钮。
步骤二:启动灰度
如下图所示,请点击新平台证书旁的“启动灰度”按钮。
步骤三:选择灰度方式
平台证书更换工具提供了提供了两种灰度方式:
步骤四:验证使用新证书验签成功
启用灰度模式后,需迅速检查监控信息以及系统日志,确保商户端系统已接收到新的证书信息及其签名,并对签名的有效性进行核实。
在灰度操作期间,若商户系统遭遇验签不通过或其他异常情况,请立即执行【终止灰度】操作,以终止灰度进程。终止灰度之后,微信支付将转而采用旧平台证书所关联的私钥进行签名,而商户则需使用旧平台证书来验证这些签名。
仅支持部署一份平台证书的商户
若商户的操作系统仅能容纳单一微信支付凭证,并且缺乏开发技术以支持多证书的验证签发,那么他们不得不暂停服务,并需进行“一次性”的证书平台更替。
此方法具有极高的风险性,若操作失误,极有可能造成商家业务长时间无法正常运行。因此,商家应尽量减少使用。
完成新证书的安装后,请商户开发者参照先前的操作指南,依次进行以下操作:
登录商户平台,进入【账户中心-API安全-平台证书】
点击“证书管理”,进入平台证书管理
点击已部署证书旁的“启动灰度”按钮,启动灰度
选取手动灰度模式,并且绕过灰度测试环节,直接将灰度比率直接设定为100%。在此情况下,微信支付将完全采用新证书所对应的私钥进行签名,而商户则需要利用新证书来核实签名。
如何修改新平台证书返回时间
微信支付旨在协助商家顺利且高效地完成新旧平台证书的更替,故在旧平台证书即将到期前180天,将同步提供新旧证书。若商家系统面临处理多份证书的困难,可延迟使用下载接口获取新证书,以便有时间对系统进行相应的升级改造。
注意:
在旧平台证书即将到期前的一百二十天到一百八十天这段时间内,系统会开放下载证书的接口管理功能,那时方可调整新平台证书的返回时间设置。
以下是具体操作步骤:
登录商户平台后,请导航至【账户中心】下的【API安全】模块,再选择【平台证书】选项,随后点击“管理证书”按钮。
2.在平台证书页面,点击“下载证书接口管理”
在下载证书的接口管理中,对新生成证书的返回时间进行修改,其最迟延迟时间可达到旧证书到期日前的120天。