最新更新時(shí)間：2019.09.16 版本說明
微信支付按天提供交易賬單文件，商戶可以通過該接口獲取賬單文件的下載地址。文件內(nèi)包含交易相關(guān)的金額、時(shí)間、營銷等信息，供商戶核對訂單、退款、銀行到賬等情況。
? 微信側(cè)未成功下單的交易不會(huì)出現(xiàn)在對賬單中。支付成功后撤銷的交易會(huì)出現(xiàn)在對賬單中，跟原支付單訂單號(hào)一致；
? 對賬單中涉及金額的字段單位為“元”；
? 對賬單接口只能下載三個(gè)月以內(nèi)的賬單。
? 小微商戶不單獨(dú)提供對賬單下載，如有需要，可在調(diào)取“下載對賬單”API接口時(shí)不傳sub_mch_id，獲取服務(wù)商下全量電商二級(jí)商戶（包括小微商戶和非小微商戶）的對賬單。
適用對象：電商平臺(tái)
請求URL：https://api.mch.weixin.qq.com/v3/bill/tradebill
請求方式：GET
接口規(guī)則：https://wechatpay-api.gitbook.io/wechatpay-api-v3
path 指該參數(shù)需在請求URL傳參
query 指該參數(shù)需在請求JSON傳參
| 參數(shù)名 | 變量 | 類型 | 必填 | 描述 |
|---|---|---|---|---|
| 賬單日期 | bill_date | string(10) | 是 | path 格式Y(jié)YYY-MM-DD 僅支持三個(gè)月內(nèi)的賬單下載申請。 示例值：2019-06-11 |
| 二級(jí)商戶號(hào) | sub_mchid | string(12) | 否 | path 1、若商戶是直連商戶：無需填寫該字段。 2、若商戶是服務(wù)商： ● 不填則默認(rèn)返回服務(wù)商下的交易或退款數(shù)據(jù)。 ● 如需下載某個(gè)子商戶下的交易或退款數(shù)據(jù)，則該字段必填。 特殊規(guī)則：最小字符長度為8 示例值：1900000001 |
| 賬單類型 | bill_type | string(32) | 否 | path 不填則默認(rèn)是ALL 枚舉值： ALL：返回當(dāng)日所有訂單信息（不含充值退款訂單） SUCCESS：返回當(dāng)日成功支付的訂單（不含充值退款訂單） REFUND：返回當(dāng)日退款訂單（不含充值退款訂單） 示例值：ALL |
| 壓縮類型 | tar_type | string(32) | 否 | path 不填則默認(rèn)是數(shù)據(jù)流 枚舉值： GZIP：返回格式為.gzip的壓縮包賬單 示例值：GZIP |
https://api.mch.weixin.qq.com/v3/bill/tradebill?bill_date=2019-06-11&sub_mchid=1900000001&bill_type=ALL
| 參數(shù)名 | 變量 | 類型 | 必填 | 描述 |
|---|---|---|---|---|
| 哈希類型 | hash_type | string(32) | 是 | 從download_url下載的文件的哈希類型，用于校驗(yàn)文件的完整性。 示例值：SHA1 |
| 哈希值 | hash_value | string(1024) | 是 | 從download_url下載的文件的哈希值，用于校驗(yàn)文件的完整性。 示例值：79bb0f45fc4c42234a918000b2668d689e2bde04 |
| 賬單下載地址 | download_url | string(2048) | 是 | 供下一步請求賬單文件的下載地址，該地址30s內(nèi)有效。 示例值：https://api.mch.weixin.qq.com/v3/billdownload/file?token=xxx |
{
"hash_type": "SHA1",
"hash_value": "79bb0f45fc4c42234a918000b2668d689e2bde04",
"download_url": " https://api.mch.weixin.qq.com/v3/billdownload/file?token=xxx"
}
| 狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 500 | SYSTEM_ERROR | 系統(tǒng)錯(cuò)誤 | 系統(tǒng)異常，請使用相同參數(shù)稍后重新調(diào)用 |
| 400 | PARAM_ERROR | 參數(shù)錯(cuò)誤 | 請使用正確的參數(shù)重新調(diào)用 |
| 400 | INVALID_REQUEST | 參數(shù)錯(cuò)誤 | 請檢查bill_date，并重新調(diào)用 |
| 參數(shù)錯(cuò)誤 | 請檢查sub_mchid，并重新調(diào)用 | ||
| 403 | NO_AUTH | 權(quán)限異常（無該子商戶賬單的權(quán)限） | 請使用正確的sub_mchid再重新調(diào)用 |
| 權(quán)限異常，小微商戶不單獨(dú)提供對賬單下載 | 可以不傳sub_mch_id，以獲取服務(wù)商下全量電商二級(jí)商戶（包括小微商戶和非小微商戶）的對賬單 | ||
| 400 | NO_STATEMENT_EXIST | 賬單文件不存在 | 請檢查當(dāng)前商戶號(hào)是否在指定日期有交易或退款發(fā)生 |
| 400 | STATEMENT_CREATING | 賬單生成中 | 請先檢查當(dāng)前商戶號(hào)在指定日期內(nèi)是否有成功的交易或退款，若有，則在T+1日上午8點(diǎn)后再重新下載 |
| 400 | NO_STATEMENT_EXIST | 賬單文件不存在 | 請檢查當(dāng)前商戶號(hào)請求的微信支付賬戶在指定日期是否有資金操作 |
| 400 | STATEMENT_CREATING | 賬單生成中 | 請先檢查當(dāng)前商戶號(hào)的微信支付賬戶在指定日期內(nèi)是否有資金操作，若有，則在T+1日上午10點(diǎn)后再重新下載 |
| 400 | INVALID_REQUEST | 參數(shù)錯(cuò)誤 | 請按第一步申請賬單的API指引，重新獲取賬單地址后再請求 |
| 403 | NO_AUTH | 權(quán)限異常 | 請檢查本次請求的商戶是否與第一步申請賬單API的請求商戶一致 |