最新更新時(shí)間:2019.09.16 版本說明
微信支付按天提供微信支付賬戶的資金流水賬單文件,商戶可以通過該接口獲取賬單文件的下載地址。文件內(nèi)包含該賬戶資金操作相關(guān)的業(yè)務(wù)單號(hào)、收支金額、記賬時(shí)間等信息,供商戶進(jìn)行核對(duì)。
? 資金賬單中的數(shù)據(jù)反映的是商戶微信支付賬戶資金變動(dòng)情況;
? 對(duì)賬單中涉及金額的字段單位為“元”。
適用對(duì)象:電商平臺(tái)
請(qǐng)求URL:https://api.mch.weixin.qq.com/v3/bill/fundflowbill
請(qǐng)求方式:GET
接口規(guī)則:https://wechatpay-api.gitbook.io/wechatpay-api-v3
path 指該參數(shù)需在請(qǐng)求URL傳參
query 指該參數(shù)需在請(qǐng)求JSON傳參
參數(shù)名 | 變量 | 類型 | 必填 | 描述 |
---|---|---|---|---|
賬單日期 | bill_date | string(10) | 是 | path 格式Y(jié)YYY-MM-DD 僅支持三個(gè)月內(nèi)的賬單下載申請(qǐng)。 示例值:2019-06-11 |
資金賬戶類型 | account_type | string(32) | 否 | path 不填則默認(rèn)是BASIC 枚舉值: BASIC:基本賬戶 OPERATION:運(yùn)營(yíng)賬戶 FEES:手續(xù)費(fèi)賬戶 示例值:BASIC |
壓縮類型 | tar_type | string(32) | 否 | path 不填則默認(rèn)是數(shù)據(jù)流 枚舉值: GZIP:返回格式為.gzip的壓縮包賬單 示例值:GZIP |
https://api.mch.weixin.qq.com/v3/bill/fundflowbill?bill_date=2019-06-11&account_type=BASIC
參數(shù)名 | 變量 | 類型 | 必填 | 描述 |
---|---|---|---|---|
哈希類型 | hash_type | string(32) | 是 | 從download_url下載的文件的哈希類型,用于校驗(yàn)文件的完整性。 示例值:SHA1 |
哈希值 | hash_value | string(1024) | 是 | 從download_url下載的文件的哈希值,用于校驗(yàn)文件的完整性。 示例值:79bb0f45fc4c42234a918000b2668d689e2bde04 |
賬單下載地址 | download_url | string(2048) | 是 | 供下一步請(qǐng)求賬單文件的下載地址,該地址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)異常,請(qǐng)使用相同參數(shù)稍后重新調(diào)用 |
400 | PARAM_ERROR | 參數(shù)錯(cuò)誤 | 請(qǐng)使用正確的參數(shù)重新調(diào)用 |
400 | INVALID_REQUEST | 參數(shù)錯(cuò)誤 | 請(qǐng)檢查bill_date,并重新調(diào)用 |
參數(shù)錯(cuò)誤 | 請(qǐng)檢查sub_mchid,并重新調(diào)用 | ||
403 | NO_AUTH | 權(quán)限異常(無該子商戶賬單的權(quán)限) | 請(qǐng)使用正確的sub_mchid再重新調(diào)用 |
權(quán)限異常,小微商戶不單獨(dú)提供對(duì)賬單下載 | 可以不傳sub_mch_id,以獲取服務(wù)商下全量電商二級(jí)商戶(包括小微商戶和非小微商戶)的對(duì)賬單 | ||
400 | NO_STATEMENT_EXIST | 賬單文件不存在 | 請(qǐng)檢查當(dāng)前商戶號(hào)是否在指定日期有交易或退款發(fā)生 |
400 | STATEMENT_CREATING | 賬單生成中 | 請(qǐng)先檢查當(dāng)前商戶號(hào)在指定日期內(nèi)是否有成功的交易或退款,若有,則在T+1日上午8點(diǎn)后再重新下載 |
400 | NO_STATEMENT_EXIST | 賬單文件不存在 | 請(qǐng)檢查當(dāng)前商戶號(hào)請(qǐng)求的微信支付賬戶在指定日期是否有資金操作 |
400 | STATEMENT_CREATING | 賬單生成中 | 請(qǐng)先檢查當(dāng)前商戶號(hào)的微信支付賬戶在指定日期內(nèi)是否有資金操作,若有,則在T+1日上午10點(diǎn)后再重新下載 |
400 | INVALID_REQUEST | 參數(shù)錯(cuò)誤 | 請(qǐng)按第一步申請(qǐng)賬單的API指引,重新獲取賬單地址后再請(qǐng)求 |
403 | NO_AUTH | 權(quán)限異常 | 請(qǐng)檢查本次請(qǐng)求的商戶是否與第一步申請(qǐng)賬單API的請(qǐng)求商戶一致 |