支付回調(diào)和查單實現(xiàn)指引
背景
由于網(wǎng)絡(luò)異常或者系統(tǒng)的波動，可能會導(dǎo)致用戶支付成功，但是商戶側(cè)未能成功接收到支付結(jié)果通知，進而顯示訂單未支付的情況。商戶側(cè)的訂單狀態(tài)更新不及時，容易造成用戶投訴，甚至是重復(fù)支付的情況發(fā)生。
目標(biāo)
商戶在未能收到支付結(jié)果通知時，也能及時、準確地獲取到訂單的支付狀態(tài)，提升商戶系統(tǒng)的健壯性，減少因為訂單狀態(tài)不同步導(dǎo)致的用戶投訴。
方案概述
1、商戶APP或者前端頁面收到支付返回時，商戶需要調(diào)用商戶查單接口確認訂單狀態(tài)，并把查詢結(jié)果展示給用戶。
2、商戶后臺需要準確、高效地處理微信支付發(fā)送的異步支付結(jié)果通知，并按接口規(guī)范把處理結(jié)果返回給微信支付。
3、商戶后臺未收到異步支付結(jié)果通知時，商戶應(yīng)該主動調(diào)用《微信支付查單接口》，同步訂單狀態(tài)。
4、商戶在T+1日從微信支付側(cè)獲取T日的交易賬單，并與商戶系統(tǒng)中的訂單核對。如出現(xiàn)訂單在微信支付側(cè)成功，但是在商戶側(cè)未成功的情況，商戶需要給用戶補發(fā)貨或者退款處理。
前端支付返回處理
【H5支付】
1、前端返回至發(fā)起支付的頁面或者返回至指定的redirect_url頁面，需要在頁面設(shè)置一個“已完成支付”的按鈕讓用戶點擊。
返回頁面展示效果（僅供參考）
2、用戶點擊“已完成支付”按鈕，商戶需要調(diào)用商戶查單接口，確認訂單狀態(tài)。
1） 如果商戶查單接口明確返回支付成功，則給用戶展示支付成功頁。
2） 如果商戶查單接口返回訂單未支付，需要提醒用戶“稍后進入訂單管理頁核實訂單狀態(tài)，不要重復(fù)發(fā)起支付”。 商戶后端需要及時獲取、更新訂單狀態(tài)，實現(xiàn)邏輯參考【后端服務(wù)處理】。當(dāng)用戶再次進入訂單管理頁面，對未支付的訂單再次發(fā)起支付時，商戶應(yīng)該使用原單號發(fā)起，不要更換支付單號，避免用戶重復(fù)支付。
【NATIVE支付】
前端顯示支付二維碼之后，前端定時輪詢調(diào)用商戶查單接口確認訂單的狀態(tài)。
頁面展示效果（僅供參考）
比如間隔2秒查詢一次，一直輪詢60秒。（輪詢時間間隔和次數(shù)，商戶可以根據(jù)自身業(yè)務(wù)場景靈活設(shè)置）
1）如果輪詢商戶查單接口返回支付成功，則給用戶展示支付成功頁。
2）如果超過系統(tǒng)設(shè)置的時間，商戶查單接口仍未返回支付成功，則退出輪詢，提醒用戶交易超時。
常見問題
1、前端返回如何區(qū)分是成功返回，還是用戶取消支付或者異常？
公眾號支付，通過JSAPI返回的res.err_msg值判斷：
小程序支付，通過回調(diào)類型判斷：
APP支付，通過onResp函數(shù)返回的errCode值判斷：
2、如何判斷微信支付查單接口返回的訂單狀態(tài)是支付成功？
商戶收到《微信支付查單接口》的響應(yīng)報文，驗證簽名成功，并且返回的return_code、result_code、trade_state這3個參數(shù)值同時為SUCCESS，則認為訂單是支付成功；調(diào)用查單接口遇到網(wǎng)絡(luò)超時，未收到返回，或者返回的return_code和result_code不同時為SUCCESS，則代表訂單狀態(tài)不明確，需要再次調(diào)用查單接口確認。