# 下載接口說明
微信支付按天提供微信支付賬戶的資金流水賬單文件,電商平臺可以通過該接口獲取二級商戶賬單文件的下載地址。文件內(nèi)包含電商平臺二級商戶資金操作相關的業(yè)務單號、收支金額、記賬時間等信息,供電商平臺進行核對。
注意
- 調用該接口前,電商平臺需提前聯(lián)系微信支付運營同學申請權限入口,申請通過后方可在【服務商平臺 (opens new window)?->?產(chǎn)品中心】自助開通“下載二級商戶資金賬單”產(chǎn)品權限;
- 資金賬單中的數(shù)據(jù)反映的是電商平臺二級商戶微信支付賬戶資金變動情況;
- 當日賬單在次日上午9點開始生成,建議商戶在上午10點以后獲取;
- 資金賬單中涉及金額的字段單位為“元”;
- 二級商戶資金流水賬單僅能通過該接口下載,且只能下載三個月以內(nèi)的賬單,請及時下載留存。
# 文件格式說明
賬單文件包括明細數(shù)據(jù)和匯總數(shù)據(jù)兩部分,每一部分都包含一行表頭和若干行具體數(shù)據(jù)。 明細數(shù)據(jù)每一行對應一筆資金操作,同時每一個數(shù)據(jù)前加入了字符`,以避免數(shù)據(jù)被Excel按科學計數(shù)法處理。如需匯總金額等數(shù)據(jù),可以批量替換掉該字符。
# 接口說明
支持商戶:
【電商平臺】
請求方式:
【GET】/v3/ecommerce/bill/fundflowbill
請求域名:
【主域名】
https://api.mch.weixin.qq.com
使用該域名將訪問就近的接入點【備域名】
https://api2.mch.weixin.qq.com
使用該域名將訪問異地的接入點 ,指引點擊查看
# 請求參數(shù)
- Authorization 必填 string請參考 簽名認證 生成認證信息
- Content-Type 必填 string
application/json
- Accept 必填 string
application/json
Header HTTP頭參數(shù)
- bill_date 必填 string(10)賬單日期,格式y(tǒng)yyy-MM-dd,僅支持三個月內(nèi)的賬單下載申請。
- account_type 必填 string資金賬戶類型,本接口只支持填ALL
可選取值:ALL
: 所有賬戶(該枚舉值只限電商平臺下載二級商戶資金流水賬單場景使用)
- tar_type 選填 string壓縮類型,不填則以不壓縮的方式返回數(shù)據(jù)流
可選取值:GZIP
: GZIP格式壓縮,返回格式為.gzip的壓縮包賬單
- algorithm 必填 string賬單文件加密算法
可選取值:AEAD_AES_256_GCM
: AEAD_AES_256_GCM加密算法SM4_GCM
: SM4_GCM加密算法,密鑰長度128bit
Query 查詢參數(shù)
請求示例
GET
# 應答參數(shù)
- download_bill_count 必填 integer下載信息總數(shù)
- download_bill_list 選填 array[EncryptBillEntity]下載信息明細
- 屬性
200OK
應答示例
200 OK
# 錯誤碼
# 公共錯誤碼
狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
---|---|---|---|
400 | PARAM_ERROR | 參數(shù)錯誤 | 請根據(jù)錯誤提示正確傳入?yún)?shù) |
400 | INVALID_REQUEST | HTTP 請求不符合微信支付 APIv3 接口規(guī)則 | 請參閱 接口規(guī)則 |
401 | SIGN_ERROR | 驗證不通過 | 請參閱 簽名常見問題 |
500 | SYSTEM_ERROR | 系統(tǒng)異常,請稍后重試 | 請稍后重試 |
# 業(yè)務錯誤碼
狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
---|---|---|---|
400 | INVALID_REQUEST | 參數(shù)錯誤 | 請檢查bill_date,僅支持下載3個月以內(nèi)的資金流水賬單 |
400 | NO_STATEMENT_EXIST | 請求的賬單文件不存在 | 請檢查電商平臺二級商戶在指定日期是否有資金操作 |
400 | STATEMENT_CREATING | 賬單生成中 | 請先檢查電商平臺二級商戶在指定日期內(nèi)是否有資金操作,若有,則在T+1日上午10點后再重新下載 |
403 | NO_AUTH | 權限異常 | 請檢查mchid是否為電商平臺 |
403 | NO_AUTH | 權限異常 | 請在產(chǎn)品中心開通下載二級商戶資金賬單產(chǎn)品權限 |
429 | FREQUENCY_LIMITED | 請求過于頻繁 | 請降低調用頻率 |