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