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

申請(qǐng)交易賬單

更新時(shí)間：2023.08.23

# 下載接口說(shuō)明

微信支付按天提供交易賬單文件，商戶可以通過(guò)該接口獲取賬單文件的下載地址。文件內(nèi)包含交易相關(guān)的金額、時(shí)間、營(yíng)銷等信息，供商戶核對(duì)訂單、退款、銀行到賬等情況。

注意：

  • 微信側(cè)未成功下單的交易不會(huì)出現(xiàn)在對(duì)賬單中。支付成功后撤銷的交易會(huì)出現(xiàn)在對(duì)賬單中，跟原支付單訂單號(hào)一致；
  • 對(duì)賬單中涉及金額的字段單位為“元”；
  • 對(duì)賬單接口只能下載三個(gè)月以內(nèi)的賬單；
  • 小微商戶不單獨(dú)提供對(duì)賬單下載，如有需要，可聯(lián)系發(fā)起交易的服務(wù)商。

# 接口說(shuō)明

支持商戶：
【普通服務(wù)商】【平臺(tái)商戶】
請(qǐng)求方式：
【GET】/v3/bill/tradebill
請(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
    Query 查詢參數(shù)
  • bill_date 必填 string(10)
    【賬單日期】 賬單日期，格式y(tǒng)yyy-MM-DD，僅支持三個(gè)月內(nèi)的賬單下載申請(qǐng)。
  • sub_mchid 選填 string(12)
    【子商戶號(hào)】 若商戶是直連商戶：
    * 無(wú)需填寫該字段
    若商戶是服務(wù)商：
    * 不填則默認(rèn)返回服務(wù)商下的交易或退款數(shù)據(jù)
    * 如需下載某個(gè)子商戶下的交易或退款數(shù)據(jù)，則該字段必填
  • bill_type 選填 string
    【賬單類型】 賬單類型，不填則默認(rèn)是ALL
    可選取值：
    • ALL: 返回當(dāng)日所有訂單信息（不含充值退款訂單）
    • SUCCESS: 返回當(dāng)日成功支付的訂單（不含充值退款訂單）
    • REFUND: 返回當(dāng)日退款訂單（不含充值退款訂單）
    • RECHARGE_REFUND: 返回當(dāng)日充值退款訂單
    • ALL_SPECIAL: 返回個(gè)性化賬單當(dāng)日所有訂單信息
    • SUC_SPECIAL: 返回個(gè)性化賬單當(dāng)日成功支付的訂單
    • REF_SPECIAL: 返回個(gè)性化賬單當(dāng)日退款訂單
  • tar_type 選填 string
    【壓縮類型】 壓縮類型，不填則以不壓縮的方式返回?cái)?shù)據(jù)流
    可選取值：
    • GZIP: GZIP格式壓縮，返回格式為.gzip的壓縮包賬單

請(qǐng)求示例

GET

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

    200OK
  • hash_type 必填 string
    【哈希類型】 哈希類型
    可選取值：
    • SHA1: Secure Hash Algorithm 1
  • hash_value 必填 string(1024)
    【哈希值】 原始賬單（gzip需要解壓縮）的摘要值，用于校驗(yàn)文件的完整性
  • download_url 必填 string(2048)
    【下載地址】 供下一步請(qǐng)求賬單文件的下載地址，該地址5min內(nè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 參數(shù)錯(cuò)誤 請(qǐng)檢查bill_date，并重新調(diào)用
400 INVALID_REQUEST 參數(shù)錯(cuò)誤 請(qǐng)檢查sub_mchid，并重新調(diào)用
400 NO_STATEMENT_EXIST 賬單文件不存在 請(qǐng)檢查當(dāng)前商戶號(hào)是否在指定日期有交易或退款發(fā)生
400 STATEMENT_CREATING 賬單生成中 請(qǐng)先檢查當(dāng)前商戶號(hào)在指定日期內(nèi)是否有成功的交易或退款，若有，則在T+1日上午10點(diǎn)后再重新下載
403 NO_AUTH 權(quán)限異常（無(wú)該子商戶賬單的權(quán)限） 請(qǐng)使用正確的sub_mchid再重新調(diào)用
403 NO_AUTH 權(quán)限異常，小微商戶不單獨(dú)提供對(duì)賬單下載 可以不傳sub_mchid，以獲取服務(wù)商下全量商戶（包括小微商戶和非小微商戶）的對(duì)賬單
429 FREQUENCY_LIMITED 請(qǐng)求過(guò)于頻繁 請(qǐng)降低調(diào)用頻率