1. 背景
微信支付提供了查詢訂單API作為合作商戶/機(jī)構(gòu)確認(rèn)訂單狀態(tài)的兜底能力。當(dāng)出現(xiàn)網(wǎng)絡(luò)抖動(dòng)或回調(diào)通知服務(wù)異常時(shí)，商戶/機(jī)構(gòu)需要主動(dòng)調(diào)用查詢訂單API以獲取訂單狀態(tài)。
2. 影響
? 商戶/機(jī)構(gòu)口碑：若商戶/機(jī)構(gòu)沒有在系統(tǒng)內(nèi)實(shí)現(xiàn)查詢訂單的能力，支付結(jié)果通知（支付回調(diào)）將成為商戶/機(jī)構(gòu)唯一實(shí)時(shí)獲取訂單狀態(tài)的渠道。若回調(diào)通知地址出現(xiàn)服務(wù)異常，會導(dǎo)致異常時(shí)間內(nèi)所有訂單的狀態(tài)均無法在系統(tǒng)內(nèi)同步，進(jìn)而導(dǎo)致商家大面積無法使用微信支付，引起用戶投訴，最終嚴(yán)重影響機(jī)構(gòu)，商戶及微信支付的口碑；
? 單邊賬投訴：若因網(wǎng)絡(luò)抖動(dòng)或短時(shí)間回調(diào)異常導(dǎo)致商戶/機(jī)構(gòu)系統(tǒng)未能同步訂單狀態(tài)，且商戶/機(jī)構(gòu)沒有在系統(tǒng)內(nèi)實(shí)現(xiàn)查單邏輯。則可能導(dǎo)致用戶實(shí)際已發(fā)生扣款，而商戶/機(jī)構(gòu)系統(tǒng)卻長時(shí)間認(rèn)定訂單尚未支付，不能向用戶發(fā)貨，最終導(dǎo)致用戶單邊賬投訴。
3. 目標(biāo)
無論是哪一類影響，都會導(dǎo)致用戶對機(jī)構(gòu)/商戶服務(wù)質(zhì)量及微信支付服務(wù)穩(wěn)定性的懷疑和負(fù)面認(rèn)知。因此機(jī)構(gòu)/商戶都需要在收單系統(tǒng)內(nèi)實(shí)現(xiàn)查詢訂單的功能邏輯，即使在無法接收回調(diào)通知的情況下，也能夠及時(shí)獲取到訂單狀態(tài)，以此提高系統(tǒng)服務(wù)的穩(wěn)定性。
4. 查單邏輯實(shí)現(xiàn)建議
注意 本查單邏輯建議僅針對除付款碼支付之外的其他支付場景，即native支付，JSAPI支付，APP支付場景下的查單策略建議。
我們提供兩套查單方案供機(jī)構(gòu)優(yōu)化系統(tǒng)參考：
方案一
一般情況下，當(dāng)支付完成時(shí)，微信支付會向商戶/機(jī)構(gòu)的回調(diào)通知地址發(fā)送支付成功通知。商戶/機(jī)構(gòu)在收到回調(diào)后，需要返回指定的內(nèi)容并更新訂單狀態(tài)到訂單數(shù)據(jù)庫當(dāng)中，如下所示：
注意 若收到回調(diào)后返回內(nèi)容不合法，或未返回內(nèi)容，微信支付會認(rèn)定本次回調(diào)失敗，并多次重試回調(diào)。
但當(dāng)發(fā)生系統(tǒng)或網(wǎng)絡(luò)抖動(dòng)，以及商戶回調(diào)地址不可用的情況時(shí)，商戶/機(jī)構(gòu)需要通過主動(dòng)調(diào)用查詢API來獲取訂單狀態(tài)。
機(jī)構(gòu)/商戶可以在訂單業(yè)務(wù)有效期終止（訂單過期）時(shí)觸發(fā)一次查單，以保證訂單過期時(shí)所記錄的狀態(tài)為正確狀態(tài)。這樣可以保證對未支付成功的訂單進(jìn)行關(guān)單，對已支付成功的訂單發(fā)起退款。故而避免了單邊賬的產(chǎn)生。具體邏輯如下圖所示：
但此方案的查單失效仍然存在一定的延遲，可能導(dǎo)致用戶等待時(shí)間過長而產(chǎn)生投訴，因此在條件允許的情況下，我們建議參考方案二進(jìn)行優(yōu)化。
方案二
等待回調(diào)部分的邏輯與方案一相同，但對于查詢訂單邏輯的設(shè)計(jì)，我們建議機(jī)構(gòu)/商戶建立兩條查單鏈路，一條通過前端回調(diào)觸發(fā)，另一條則在下單時(shí)即觸發(fā)進(jìn)入任務(wù)隊(duì)列。
當(dāng)商戶/下單時(shí)，訂單數(shù)據(jù)即寫入商戶訂單數(shù)據(jù)庫，同步開始將訂單加入查單隊(duì)列，按照一定頻率調(diào)用微信支付查詢訂單API來查詢訂單狀態(tài)，如下所示。
注意 有關(guān)查單隊(duì)列調(diào)用微信支付查詢API的頻率及次數(shù)，商戶/機(jī)構(gòu)可根據(jù)自身的業(yè)務(wù)情況來決定，微信支付官方不提供細(xì)節(jié)建議。
對于存在前端頁面或應(yīng)用回調(diào)的場景（包括APP支付/小程序支付/H5支付/JSAPI支付），當(dāng)用戶完成支付后跳回商戶/機(jī)構(gòu)的APP/小程序/網(wǎng)頁時(shí)，機(jī)構(gòu)/商戶會收到前端返回（調(diào)用JSAPI，或SDK的返回），商戶/機(jī)構(gòu)可根據(jù)前端返回來判斷用戶是否取消了支付。若前端返回為fail，則確認(rèn)用戶取消支付，可將該訂單直接從查單隊(duì)列中移除，即不再需要查單；若前端返回為success，則確認(rèn)用戶未取消支付，但支付最終是否成功則需要依賴后臺的回調(diào)或查詢訂單結(jié)果。
若確認(rèn)用戶未取消支付，則此時(shí)觸發(fā)一次商戶/機(jī)構(gòu)內(nèi)部的訂單查詢服務(wù)，即商戶/機(jī)構(gòu)查單模塊在后臺數(shù)據(jù)庫內(nèi)查詢訂單當(dāng)前的狀態(tài)。此時(shí)商戶/機(jī)構(gòu)若已成功收到回調(diào)，則查詢訂單數(shù)據(jù)為success，查詢服務(wù)模塊可將訂單狀態(tài)同步到前端，在商戶/機(jī)構(gòu)的業(yè)務(wù)頁面上展示支付成功信息；若此時(shí)回調(diào)尚未觸達(dá)，或因?yàn)槠渌驅(qū)е聼o法收到回調(diào)，則該訂單狀態(tài)需通過查單隊(duì)列的結(jié)果確認(rèn)，如下圖所示：
5. 訂單閉環(huán)處理
我們建議機(jī)構(gòu)或商戶在最后一次查單獲取交易狀態(tài)非SUCCESS情況下，立即調(diào)用關(guān)單接口，中間切勿留有時(shí)間差。
注意 關(guān)閉訂單接口僅可針對未支付成功的訂單進(jìn)行調(diào)用。
6. 事后兜底處理
商戶在T+1日上午10點(diǎn)以后，調(diào)用《微信支付對賬單下載接口》，或者登錄微信商戶平臺手工下載T日交易賬單，然后根據(jù)對賬單中的訂單數(shù)據(jù)，逐筆與商戶系統(tǒng)中的訂單核對。
核對時(shí)有如下幾種情況：
1) 訂單匹配成功，并且狀態(tài)都是支付成功：正常情況，對賬成功。
2) 訂單匹配成功，但是商戶側(cè)狀態(tài)非支付成功：商戶根據(jù)自身業(yè)務(wù)情況，決定是否把訂單狀態(tài)更新為支付成功并給用戶發(fā)貨，或者是給用戶發(fā)起退款。
3) 訂單匹配失敗，對賬單中的單號在商戶系統(tǒng)未找到記錄：異常情況，需要商戶排查系統(tǒng)是否出現(xiàn)數(shù)據(jù)異常。
4) 訂單匹配失敗，商戶系統(tǒng)中成功的訂單在對賬單中未找到記錄：異常情況，需要商戶排查是否訂單處理邏輯有bug。
頁面導(dǎo)航
