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