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