视频一区二区三区自拍_千金肉奴隷1985未删减版在线观看_国产成人黄色视频在线播放_少女免费播放片高清在线观看_国产精品v欧美精品v

微信支付商戶訂單號查詢訂單

更新時間：2023.08.23

商戶可以通過查詢訂單接口主動查詢訂單狀態(tài)，完成下一步的業(yè)務邏輯。

查詢訂單可通過微信支付訂單號 (opens new window)和商戶訂單號 (opens new window)兩種方式查詢。

需要調用查詢接口的情況：

  • 當商戶后臺、網絡、服務器等出現異常，商戶系統(tǒng)最終未接收到支付通知。
  • 調用支付接口后，返回系統(tǒng)錯誤或未知交易狀態(tài)情況。
  • 調用付款碼支付API，返回USERPAYING的狀態(tài)。
  • 調用關單或撤銷接口API之前，需確認支付狀態(tài)。

# 接口說明

支持商戶：
【普通服務商】【平臺商戶】
請求方式：
【GET】/v3/pay/partner/transactions/out-trade-no/{out_trade_no}
請求域名：
【主域名】
https://api.mch.weixin.qq.com
使用該域名將訪問就近的接入點
【備域名】
https://api2.mch.weixin.qq.com
使用該域名將訪問異地的接入點 ，指引點擊查看

# 請求參數

    Header HTTP頭參數
  • Authorization 必填 string
    請參考 簽名認證 生成認證信息
  • Accept 必填 string
    請設置為 application/json
    Path 路徑參數
  • out_trade_no 必填 string(32)
    【商戶訂單號】 商戶系統(tǒng)內部訂單號，只能是數字、大小寫字母_-*且在同一個商戶號下唯一。
    特殊規(guī)則：最小字符長度為6
    Query 查詢參數
  • sp_mchid 必填 string(32)
    【服務商戶號】 服務商戶號
  • sub_mchid 必填 string(32)
    【子商戶號】 子商戶號

請求示例

GET

# 應答參數

    200OK
  • sp_appid 選填 string(32)
    【服務商公眾號ID】 服務商申請的公眾號或移動應用AppID
  • sp_mchid 必填 string(32)
    【服務商戶號】 服務商戶號
  • sub_appid 選填 string(32)
    【子商戶公眾號ID】 子商戶公眾號ID
  • sub_mchid 必填 string(32)
    【子商戶號】 子商戶號
  • out_trade_no 必填 string(32)
    【商戶訂單號】 商戶系統(tǒng)內部訂單號，只能是數字、大小寫字母_-*且在同一個商戶號下唯一。
    特殊規(guī)則：最小字符長度為6
  • transaction_id 選填 string(32)
    【微信支付訂單號】 微信支付訂單號
  • trade_type 選填 string(16)
    【交易類型】 交易類型，枚舉值：
    * JSAPI：公眾號支付
    * NATIVE：掃碼支付
    * APP：APP支付
    * MICROPAY：付款碼支付
    * MWEB：H5支付
    * FACEPAY：刷臉支付
  • trade_state 必填 string(32)
    【交易狀態(tài)】 交易狀態(tài)，枚舉值：
    * SUCCESS：支付成功
    * REFUND：轉入退款
    * NOTPAY：未支付
    * CLOSED：已關閉
    * REVOKED：已撤銷（僅付款碼支付會返回）
    * USERPAYING：用戶支付中（僅付款碼支付會返回）
    * PAYERROR：支付失敗（僅付款碼支付會返回）
  • trade_state_desc 必填 string(256)
    【交易狀態(tài)描述】 交易狀態(tài)描述
  • bank_type 選填 string(32)
    【銀行類型】 銀行類型，采用字符串類型的銀行標識。 銀行標識請參考《銀行類型對照表》
  • attach 選填 string(128)
    【附加數據】 附加數據
  • success_time 選填 string(64)
    【支付完成時間】 支付完成時間，遵循rfc3339標準格式，格式為yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出現在字符串中，表示time元素的開頭，HH:mm:ss表示時分秒，TIMEZONE表示時區(qū)（+08:00表示東八區(qū)時間，領先UTC?8小時，即北京時間）。例如：2015-05-20T13:29:35+08:00表示，北京時間2015年5月20日13點29分35秒。
  • payer 選填 PartnerCommRespPayerInfo
    【支付者】 支付者
    • 屬性
  • amount 選填 CommRespAmountInfo
    【訂單金額】 訂單金額信息，當支付成功時返回該字段。
    • 屬性
  • scene_info 選填 CommRespSceneInfo
    【場景信息】 場景信息
    • 屬性
  • promotion_detail 選填 array[PromotionDetail]
    【優(yōu)惠功能】 優(yōu)惠功能
    • 屬性

應答示例

200 OK

# 錯誤碼

# 公共錯誤碼

狀態(tài)碼 錯誤碼 描述 解決方案
400 PARAM_ERROR 參數錯誤 請根據錯誤提示正確傳入參數
400 INVALID_REQUEST HTTP 請求不符合微信支付 APIv3 接口規(guī)則 請參閱 接口規(guī)則
401 SIGN_ERROR 驗證不通過 請參閱 簽名常見問題
500 SYSTEM_ERROR 系統(tǒng)異常，請稍后重試 請稍后重試

# 業(yè)務錯誤碼

狀態(tài)碼 錯誤碼 描述 解決方案
400 APPID_MCHID_NOT_MATCH AppID和mch_id不匹配 請確認AppID和mch_id是否匹配
400 INVALID_REQUEST 無效請求 請根據接口返回的詳細信息檢查
400 MCH_NOT_EXISTS 商戶號不存在 請檢查商戶號是否正確
400 ORDER_CLOSED 訂單已關閉 當前訂單已關閉，請重新下單
401 SIGN_ERROR 簽名錯誤 請檢查簽名參數和方法是否都符合簽名算法要求
403 ACCOUNT_ERROR 賬號異常 用戶賬號異常，無需更多操作
403 NO_AUTH 商戶無權限 請商戶前往申請此接口相關權限
403 NOT_ENOUGH 余額不足 用戶賬號余額不足，請用戶充值或更換支付卡后再支付
403 OUT_TRADE_NO_USED 商戶訂單號重復 請核實商戶訂單號是否重復提交
403 RULE_LIMIT 業(yè)務規(guī)則限制 因業(yè)務規(guī)則限制請求頻率，請查看接口返回的詳細信息
403 TRADE_ERROR 交易錯誤 因業(yè)務原因交易失敗，請查看接口返回的詳細信息
404 ORDER_NOT_EXIST 訂單不存在 請檢查訂單是否發(fā)起過交易
404 ORDER_NOT_EXIST 訂單不存在 請檢查訂單是否發(fā)起過交易
429 FREQUENCY_LIMITED 頻率超限 請降低請求接口頻率
500 BANK_ERROR 銀行系統(tǒng)異常 銀行系統(tǒng)異常，請用相同參數重新調用
500 INVALID_TRANSACTIONID 訂單號非法 請檢查微信支付訂單號是否正確
500 OPENID_MISMATCH OpenID和AppID不匹配 請確認OpenID和AppID是否匹配
500 SYSTEM_ERROR 系統(tǒng)錯誤 系統(tǒng)異常，請用相同參數重新調用
反饋
咨詢
目錄