跨城冗災升級指引
最新更新時間：2021.3.9
本指引供商戶升級商戶支付系統(tǒng)參考，商戶應當根據(jù)商戶系統(tǒng)的實際情況采取相應的升級操作，并對商戶支付系統(tǒng)的安全性負責
1. 簡介
什么是冗災？異地災備的重要性？
當光纜被挖斷、機房出現(xiàn)異常，或因不可抗拒原因（如地質災害）等造成正常路徑上業(yè)務不可用，通過備份路徑和措施來保證業(yè)務繼續(xù)正常進行。
2. 商戶實現(xiàn)跨城冗災整體流程
3. 專線商戶方案
3.1. 方案A：多專線異地機房實現(xiàn)跨城冗災
| 商戶側要求 | 微信支付 | |
|---|---|---|
| 專線 | 兩條異地專線 1、如果已拉單專線，需要補一條異地專線(商戶側發(fā)起) 2、如果已有兩條同城專線，需要將其中一條改到異地機房（商戶側發(fā)起） |
提供四個專線接入點： 上海電信 上海聯(lián)通 深圳電信 深圳聯(lián)通 |
| 機房 | 無要求 | 上海 深圳 |
| 冗災規(guī)則 | 專線雙活、業(yè)務雙活（專線同時跑交易） 支持專線、機房異常、跨城冗災 |
每個中心獨立業(yè)務部署 |
| 冗災觸發(fā)機制 | 可按實際情況按以下方案實現(xiàn)： 方案1：統(tǒng)計每條專線的連接耗時、丟包率、業(yè)務成功率；出現(xiàn)異常情況可自動切換到最優(yōu)鏈路 方案2：統(tǒng)計接口（例如：下單API）成功率，失敗率升高自動啟動冗災，比如失敗率降到50%， 方案3：定時探測（例如：查單API），連續(xù)3次探測失敗（連接超時，響應超時，HTTP狀態(tài)碼：5xx表示服務器錯誤）自動啟動冗災 注意：專線回調類API有主備區(qū)分，切換路徑后，回調域名也應該換到對應域名 |
/ |
| 正常回切機制 | 有探測機制，能自動恢復雙活 | / |
跨城冗災需支持的范圍：微信支付 和 公眾平臺 業(yè)務
微信支付域名：api.mch.weixin.qq.com（主域名）； api2.mch.weixin.qq.com（備域名）
公眾平臺域名：api.weixin.qq.com（主域名）； api2.weixin.qq.com（備域名）
公眾平臺資源域名： res.wx.qq.com（主域名） ；res2.wx.qq.com（備域名）
以廣州專線商戶為例，說明冗災流程
專線應開通公眾平臺訪問策略，公眾號支付有涉及到公眾平臺授權接口調用。
3.2. 方案B：同城專線+公網(wǎng)災備實現(xiàn)跨城冗災
正常使用專線方案運行，應具備自動切換到公網(wǎng)的條件（定時探測公網(wǎng)可用性）和實現(xiàn)公網(wǎng)冗災的邏輯。
公網(wǎng)容災方案參見公網(wǎng)商戶方案。
4. 驗證
4.1. 已升級支持跨城冗災，商戶自行驗證
方案1：通過人工配置錯誤HOST模擬災情
方案2：通過機房斷專線的方式模擬
4.2. 微信支付側配合驗證
微信支付從7月份起，可配合對已完成升級的商戶進行雙方驗證。請主動聯(lián)系我們發(fā)起驗證流程。
5. 升級說明
5.1 微信支付側實現(xiàn)跨城容災，為什么還需要商戶配合？
當某個城市內的機房都不可用，微信支付側會進行災備處理，通過另外一個城市提供支付服務。商戶側需要通過主備域名切換的方式，訪問微信支付正常服務，減小故障帶來的影響。
5.2. 涉及哪些API
微信支付API
公眾平臺后臺API和前臺JS資源
5.3. 請商戶評估方案后將排期提交給微信側，有疑問請到微信開放社區(qū)咨詢，發(fā)帖標題請注明“【跨城冗災】”,也可通過郵箱WePayTS@tencent.com與我們聯(lián)系
6. 微信支付回調通知商戶
1). 商戶側與微信支付約定私有的回調域名，形如xxxx.wxpay.local，xxxx替換為商戶名稱簡寫，具體有以下兩種方案可選：
隨機模式： xxxx.wxpay.local為隨機回調域名，微信支付側會將該域名在配置文件中定義為全部回調IP，隨機選擇和重試；
主備模式： s.xxxx.wxpay.local順序模式，是將電信IP作為主回調IP的回調域名，此時聯(lián)通IP作為備用；
r.xxxx.wxpay.local逆序模式，是將聯(lián)通IP作為主回調IP的回調域名，此時電信IP作為備用；
2). 商戶可以只用隨機模式的私有回調域名，如果想要更好控制專線選擇，可以在需要切換時使用主備模式，微信支付側回調程序根據(jù)商戶側提供的私有回調域名自動適配回調IP。
3). 走專線還是走公網(wǎng)? 商戶傳的私有回調地址就走專線回調，其他回調地址類型走公網(wǎng)回調