服務(wù)商可以調(diào)用此接口獲取購付匯賬單文件下載鏈接。在有效期內(nèi)請求下載鏈接可以下載出賬日為指定日期的購付匯賬單文件。
有關(guān)賬單的說明:
- 購付匯賬單中提供的是前一天購付匯完成、最終出境成功的賬單,還未完成出境或出境失敗的出境單不會出現(xiàn)在賬單中。注:在出境請求被受理之后,預(yù)計購匯時間為T+1(其中T為受理日期)。
- 通過下載鏈接獲取到的賬單文件為資金出境購付匯賬單,出賬日期為T+1,即當(dāng)天下載的是前一天購付匯完成的出境成功賬單。
- 一般在凌晨6點后可以下載到前一天的賬單,實際賬單下載的情況請關(guān)注錯誤碼提示。
- 提示,下載三個月前或更早的歷史數(shù)據(jù)時下載速度可能會變慢。
- 賬單中涉及金額的字段單位為“元”。
當(dāng)獲取到賬單文件資源的下載地址信息后,如:
1{2 "hash_type": "SHA1",3 "hash_value": "79bb0f45fc4c42234a918000b2668d689e2bde04",4 "download_url": " https://api.mch.weixin.qq.com/v3/billdownload/file?token=xxx"5}
可以通過微信支付API v3標(biāo)準(zhǔn)對download_url進(jìn)行簽名,并發(fā)起請求,即可下載到賬單文件的數(shù)據(jù)流。
注意:
- 賬單文件的下載地址的有效時間為30s;
- 強(qiáng)烈建議商戶將實際賬單文件的哈希值和之前從接口獲取到的哈希值進(jìn)行比對,以確認(rèn)數(shù)據(jù)的完整性。
# 接口說明
支持商戶:
【普通服務(wù)商】
請求方式:
【GET】/v3/funds-to-oversea/bill-download-url
請求域名:
【主域名】
https://api.mch.weixin.qq.com
使用該域名將訪問就近的接入點【備域名】
https://api2.mch.weixin.qq.com
使用該域名將訪問異地的接入點 ,指引點擊查看
# 請求參數(shù)
- Authorization 必填 string請參考 簽名認(rèn)證 生成認(rèn)證信息
- Accept 必填 string請設(shè)置為
application/json
Header HTTP頭參數(shù)
- bill_date 必填 string(10)【賬單日期】 格式Y(jié)YYY-MM-DD
- sub_mchid 選填 string(20)【子商戶號】 若商戶是直連商戶:
- 無需填寫該字段
若商戶是服務(wù)商:
- 不填則默認(rèn)返回服務(wù)商下的賬單數(shù)據(jù)
- 如需下載某個子商戶下的賬單數(shù)據(jù),則該字段必填
Query 查詢參數(shù)
請求示例
GET
# 應(yīng)答參數(shù)
- hash_type 必填 string【哈希類型】 哈希類型
可選取值:SHA1
: Secure Hash Algorithm 1
- hash_value 必填 string(1024)【哈希值】 原始賬單(gzip需要解壓縮)的摘要值,用于校驗文件的完整性。
建議將實際賬單文件的哈希值和該哈希值進(jìn)行比對,以確認(rèn)數(shù)據(jù)的完整性。 - download_url 必填 string(2048)【下載地址】 下載地址5min內(nèi)有效
200OK
應(yīng)答示例
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è)務(wù)錯誤碼
狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
---|---|---|---|
403 | NO_AUTH | 商戶無權(quán)限申請資金出境 | 商戶無權(quán)限申請資金出境,請申請相關(guān)權(quán)限 |