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