為了幫助商戶平穩(wěn)、高效地更換新舊平臺證書，微信支付為商戶提供了微信支付平臺證書更換工具。本文面向商戶開發(fā)者介紹如何使用平臺證書更換工具，完成新舊證書的更換。

# 準備開始

商戶開發(fā)者應(yīng)仔細閱讀 微信支付平臺證書，了解平臺證書的關(guān)鍵概念和更換機制，并遵循指引實現(xiàn)商戶系統(tǒng)獲取、使用、部署和更新平臺證書等關(guān)鍵功能。

# 已支持多證書驗簽的商戶

如果商戶系統(tǒng)已經(jīng)獲取并部署了新舊證書，且支持根據(jù)微信支付 API 應(yīng)答或通知回調(diào) HTTP 頭中的 Wechatpay-Serial 選擇對應(yīng)的平臺證書驗證簽名。請參考以下步驟灰度更換平臺證書。

# 步驟一：登錄商戶平臺，進入平臺證書管理

如下圖所示，請登錄微信支付商戶平臺，進入【賬戶中心-API安全-平臺證書】，點擊“管理證書”。

# 步驟二：啟動灰度

如下圖所示，請點擊新平臺證書旁的“啟動灰度”按鈕。

# 步驟三：選擇灰度方式

平臺證書更換工具提供了提供了兩種灰度方式：

• 自動灰度：微信支付按照固定的節(jié)奏灰度更換新證書，于每周一和每周四的10:00逐步提升新證書簽名的比例
• 手動灰度：商戶開發(fā)者可自定義灰度比例，自行控制灰度進展

# 步驟四：驗證使用新證書驗簽成功

啟動灰度后，應(yīng)立即觀察監(jiān)控和系統(tǒng)日志，確認商戶系統(tǒng)收到了新證書的消息簽名，并驗證簽名成功。

# 終止灰度

在灰度過程中，若商戶系統(tǒng)出現(xiàn)驗簽失敗等異常，請及時點擊【終止灰度】，停止灰度。停止灰度后，微信支付將使用舊平臺證書對應(yīng)的私鑰簽名，商戶使用舊平臺證書驗證簽名。

# 僅支持部署一份平臺證書的商戶

若商戶系統(tǒng)僅支持一份微信支付證書，且無開發(fā)能力實現(xiàn)多證書驗簽，則只能停止服務(wù)，“一次性”更換平臺證書。

當部署完新證書后，請商戶開發(fā)者參考前一部分指引，執(zhí)行以下步驟：

1. 登錄商戶平臺，進入【賬戶中心-API安全-平臺證書】
2. 點擊“證書管理”，進入平臺證書管理
3. 點擊已部署證書旁的“啟動灰度”按鈕，啟動灰度
4. 選擇手動灰度，并跳過灰度，直接將灰度比例直接設(shè)置為100%。這時微信支付將全部使用新證書對應(yīng)的私鑰簽名，商戶須使用新證書驗證簽名。

# 如何修改新平臺證書返回時間

為了幫助商戶平穩(wěn)、高效地更換新舊平臺證書，微信支付會在舊平臺證書過期前180天開始同時返回新證書和舊證書。如果商戶系統(tǒng)無法及時處理多張證書，需要推遲下載接口返回新證書，以進行系統(tǒng)改造。

以下是具體操作步驟：

1. 登錄商戶平臺，進入【賬戶中心—API安全—平臺證書】，點擊“管理證書”
2. 在平臺證書頁面，點擊“下載證書接口管理”
3. 在下載證書接口管理，修改新證書返回的時間，最晚可推遲到舊證書過期前的120天。