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

通過(guò)商家批次單號(hào)查詢批次單

更新時(shí)間：2024.03.22

商家明細(xì)單號(hào)查單接口。商戶可以通過(guò)該接口查詢轉(zhuǎn)賬批次單以及指定狀態(tài)的轉(zhuǎn)賬明細(xì)單。返回消息中包含微信批次單號(hào)、批次狀態(tài)、批次類型、轉(zhuǎn)賬總金額、轉(zhuǎn)賬總筆數(shù)、成功金額、失敗金額等信息。

# 接口說(shuō)明

支持商戶：
【普通商戶】
請(qǐng)求方式：
【GET】/v3/transfer/batches/out-batch-no/{out_batch_no}
請(qǐng)求域名：
【主域名】
https://api.mch.weixin.qq.com
使用該域名將訪問(wèn)就近的接入點(diǎn)
【備域名】
https://api2.mch.weixin.qq.com
使用該域名將訪問(wèn)異地的接入點(diǎn) ，指引點(diǎn)擊查看

# 請(qǐng)求參數(shù)

    Header HTTP頭參數(shù)
  • Authorization 必填 string
    請(qǐng)參考 簽名認(rèn)證 生成認(rèn)證信息
  • Accept 必填 string
    請(qǐng)?jiān)O(shè)置為 application/json
    Path 路徑參數(shù)
  • out_batch_no 必填 string(32)
    【商家批次單號(hào)】 商戶系統(tǒng)內(nèi)部的商家批次單號(hào)，在商戶系統(tǒng)內(nèi)部唯一
    Query 查詢參數(shù)
  • need_query_detail 必填 boolean
    【是否查詢轉(zhuǎn)賬明細(xì)單】 true-是；false-否，默認(rèn)否。商戶可選擇是否查詢指定狀態(tài)的轉(zhuǎn)賬明細(xì)單，當(dāng)轉(zhuǎn)賬批次單狀態(tài)為“FINISHED”（已完成）時(shí)，才會(huì)返回滿足條件的轉(zhuǎn)賬明細(xì)單
  • offset 選填 integer
    【請(qǐng)求資源起始位置】 該次請(qǐng)求資源（轉(zhuǎn)賬明細(xì)單）的起始位置，從0開(kāi)始，默認(rèn)值為0
  • limit 選填 integer
    【最大資源條數(shù)】 該次請(qǐng)求可返回的最大資源（轉(zhuǎn)賬明細(xì)單）條數(shù)，最小20條，最大100條，不傳則默認(rèn)20條。不足20條按實(shí)際條數(shù)返回
  • detail_status 選填 string(32)
    【明細(xì)狀態(tài)】 WAIT_PAY: 待確認(rèn)。待商戶確認(rèn), 符合免密條件時(shí), 系統(tǒng)會(huì)自動(dòng)扭轉(zhuǎn)為轉(zhuǎn)賬中
    ALL:全部。需要同時(shí)查詢轉(zhuǎn)賬成功、失敗和待確認(rèn)的明細(xì)單
    SUCCESS:轉(zhuǎn)賬成功
    FAIL:轉(zhuǎn)賬失敗。需要確認(rèn)失敗原因后，再?zèng)Q定是否重新發(fā)起對(duì)該筆明細(xì)單的轉(zhuǎn)賬（并非整個(gè)轉(zhuǎn)賬批次單）
    當(dāng)need_query_detail為true時(shí)該字段必填

請(qǐng)求示例

GET

# 應(yīng)答參數(shù)

    200OK
  • transfer_batch 必填 TransferBatchGet
    【轉(zhuǎn)賬批次單】 轉(zhuǎn)賬批次單基本信息
    • 屬性
  • transfer_detail_list 選填 array[TransferDetailCompact]
    【轉(zhuǎn)賬明細(xì)單列表】 當(dāng)批次狀態(tài)為“FINISHED”（已完成），且成功查詢到轉(zhuǎn)賬明細(xì)單時(shí)返回。包括微信明細(xì)單號(hào)、明細(xì)狀態(tài)信息
    • 屬性

應(yīng)答示例

200 OK

# 錯(cuò)誤碼

# 公共錯(cuò)誤碼

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

# 業(yè)務(wù)錯(cuò)誤碼

狀態(tài)碼 錯(cuò)誤碼 描述 解決方案
400 INVALID_REQUEST 請(qǐng)求參數(shù)符合參數(shù)格式，但不符合業(yè)務(wù)規(guī)則 查詢單據(jù)超過(guò)限定時(shí)間(30天)，可以嘗試通過(guò)商戶平臺(tái)預(yù)約下載
404 NOT_FOUND 記錄不存在 查詢的轉(zhuǎn)賬批次單不存在
429 FREQUENCY_LIMITED 頻率超限 請(qǐng)求量不要超過(guò)接口調(diào)用頻率限制
500 SYSTEM_ERROR 系統(tǒng)錯(cuò)誤 5開(kāi)頭的狀態(tài)碼都為系統(tǒng)問(wèn)題，請(qǐng)使用相同參數(shù)稍后重新調(diào)用