摘要：本文是淺析微信支付系列文章的第七篇，主要講解微信商戶平臺的訂單查詢和關閉接口的使用。查詢訂單以下為微信官方的查詢訂單文檔應用場景該接口提供所有微信支付訂單的查詢，商戶可以通過查詢訂單接口主動查詢訂單狀態，完成下一步的業務邏輯。
本文是【淺析微信支付】系列文章的第七篇，主要講解微信商戶平臺的訂單查詢和關閉接口的使用。
淺析微信支付系列已經更新六篇了喲～，沒有看過的朋友們可以看一下哦。
淺析微信支付：支付結果通知
淺析微信支付：統一下單接口
淺析微信支付：微信公眾號網頁授權
聲明：這里的查詢訂單、關閉訂單接口僅適用于 小程序支付、公共號支付、掃碼支付、APP支付，刷卡支付方式此處并不適用。
1、查詢訂單
以下為微信官方的查詢訂單文檔：
https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_2
1.1. 應用場景
該接口提供所有微信支付訂單的查詢，商戶可以通過查詢訂單接口主動查詢訂單狀態，完成下一步的業務邏輯。
需要調用查詢接口的情況：
◆ 當商戶后臺、網絡、服務器等出現異常，商戶系統最終未接收到支付通知；
◆ 調用支付接口后，返回系統錯誤或未知交易狀態情況；
◆ 調用刷卡支付API，返回USERPAYING的狀態；
◆ 調用關單或撤銷接口API之前，需確認支付狀態；
1.2. 接口鏈接
https://api.mch.weixin.qq.com/pay/orderquery
1.3. 是否需要證書
不需要
1.4. 調用接口
查詢訂單接口需要使用微信訂單號或者商戶訂單號來查詢，其他參數為商戶平臺信息的公共參數，為常量，此處省略解釋。
微信訂單號：transaction_id（微信的訂單號，建議優先使用）
商戶訂單號：out_trade_no（商戶系統內部訂單號）
此兩個參數必填其中之一，微信推薦使用微信訂單號來查詢，下面為實現代碼：
private void doOrderQuery() {
System.out.println("查詢訂單");
HashMap data = new HashMap();
// data.put("out_trade_no", out_trade_no);
data.put("transaction_id", "4008852001201608221962061594");
try {
WXPay wxPay = new WXPay(WXPayConfigImpl.getInstance());
Map r = wxPay.orderQuery(data);
System.out.println(r);
} catch (Exception e) {
e.printStackTrace();
}
}
wxPay.orderQuery方法為封裝的sdk方法，具體實現請參考作者github源碼。
對于商戶關鍵信息的寫入，公共方法為wxPay.fillRequestData，實現如下：
/**
* 向 Map 中添加 appid、mch_id、nonce_str、sign_type、sign
* 該函數適用于商戶適用于統一下單等接口，不適用于紅包、代金券接口
*
* @param reqData r
* @return map
* @throws Exception e
*/
public Map fillRequestData(Map reqData) throws Exception {
reqData.put("appid", config.getAppID());
reqData.put("mch_id", config.getMchID());
reqData.put("nonce_str", WXPayUtil.generateNonceStr());
if (SignType.MD5.equals(this.signType)) {
reqData.put("sign_type", WXPayConstants.MD5);
} else if (SignType.HMACSHA256.equals(this.signType)) {
reqData.put("sign_type", WXPayConstants.HMACSHA256);
}
reqData.put("sign", WXPayUtil.generateSignature(reqData, config.getKey(), this.signType));
return reqData;
}
以上為查詢微信訂單的使用方式，具體的返回參數請參考官方文檔。
2、關閉訂單
以下為微信官方的關閉訂單文檔：
https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_3
2.1. 應用場景
以下情況需要調用關單接口：
商戶訂單支付失敗需要生成新單號重新發起支付，要對原訂單號調用關單，避免重復支付；
系統下單后，用戶支付超時，系統退出不再受理，避免用戶繼續，請調用關單接口。
注意：訂單生成后不能馬上調用關單接口，最短調用時間間隔為5分鐘。
2.2. 接口鏈接
https://api.mch.weixin.qq.com/pay/closeorder
2.3. 是否需要證書
不需要
2.4. 調用接口
關閉訂單接口需要使用商戶訂單號來查詢，其他參數為商戶平臺信息的公共參數，為常量，此處省略解釋。
商戶訂單號：out_trade_no（商戶系統內部訂單號）
PS：關單接口只能使用微信訂單號來查詢，和查詢接口不同，下面為實現代碼：
private void doOrderClose() {
System.out.println("關閉訂單");
HashMap data = new HashMap();
data.put("out_trade_no", out_trade_no);
try {
WXPay wxPay = new WXPay(WXPayConfigImpl.getInstance());
Map r = wxPay.closeOrder(data);
System.out.println(r);
} catch (Exception e) {
e.printStackTrace();
}
}
關單接口的公共參數設置和查詢訂單一致，這里就不重復解釋了，具體的返回參數請參考微信官方文檔。
PS：關單接口可能會調用失敗，已支付、已關閉等場景，所以需要開發者注意官方文檔中的錯誤碼，對異常情況進行處理。
結語
以上為查詢訂單、關閉訂單的調用方式，如果是刷卡支付方式，他的關閉訂單接口為撤銷訂單:reverse，在作者sdk源碼中也有具體的實現方式。
預告：下一篇文章 申請退款和退款回調接口，敬請期待！！！
?如果想要提前一覽源碼的小伙伴，可以先看看我的 github，地址如下：
?https://github.com/YClimb/wxpay-sdk/blob/master/README.md
加作者私人微信，作者微信號如下 yclimb，標明 微信支付 可拉入微信支付討論群與小伙伴一起探討哦，一定要標明 微信支付 哦～
到此本文就結束了，關注公眾號查看更多推送！！！
文章版權歸作者所有，未經允許請勿轉載,若此文章存在違規行為，您可以聯系管理員刪除。
轉載請注明本文地址：http://specialneedsforspecialkids.com/yun/72076.html
