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