最新更新時(shí)間:2022.04.19 版本說明
服務(wù)商可以調(diào)用此接口獲取購(gòu)付匯賬單文件下載鏈接。在有效期內(nèi)請(qǐng)求下載鏈接可以下載出賬日為指定日期的購(gòu)付匯賬單文件。
? 賬單文件的下載地址的有效時(shí)間為30s;
? 強(qiáng)烈建議商戶將實(shí)際賬單文件的哈希值和之前從接口獲取到的哈希值進(jìn)行比對(duì),以確認(rèn)數(shù)據(jù)的完整性。
有關(guān)賬單的說明:
購(gòu)付匯賬單中提供的是前一天購(gòu)付匯完成、最終出境成功的賬單,還未完成出境或出境失敗的出境單不會(huì)出現(xiàn)在賬單中。
注:在出境請(qǐng)求被受理之后,預(yù)計(jì)購(gòu)匯時(shí)間為T+1(其中T為受理日期)。
通過下載鏈接獲取到的賬單文件為資金出境購(gòu)付匯賬單,出賬日期為T+1,即當(dāng)天下載的是前一天購(gòu)付匯完成的出境成功賬單。
一般在凌晨6點(diǎn)后可以下載到前一天的賬單,實(shí)際賬單下載的情況請(qǐng)關(guān)注錯(cuò)誤碼提示。
提示,下載三個(gè)月前或更早的歷史數(shù)據(jù)時(shí)下載速度可能會(huì)變慢。
賬單中涉及金額的字段單位為“元”。
當(dāng)獲取到賬單文件資源的下載地址信息后, 可以通過微信支付API v3標(biāo)準(zhǔn)對(duì)download_url進(jìn)行簽名,并發(fā)起請(qǐng)求,即可下載到賬單文件的數(shù)據(jù)流。
適用對(duì)象:電商平臺(tái)
請(qǐng)求URL:https://api.mch.weixin.qq.com/v3/funds-to-oversea/bill-download-url
請(qǐng)求方式:GET
path 指該參數(shù)為路徑參數(shù)
query 指該參數(shù)為URL參數(shù)
body 指該參數(shù)需在請(qǐng)求JSON傳參
參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
---|---|---|---|---|
賬單日期 | bill_date | string[10, 10] | 是 | query格式y(tǒng)yyy-MM-DD 示例值:2021-01-01 |
子商戶號(hào) | sub_mchid | string[1, 20] | 否 | query
1. 不填則默認(rèn)返回服務(wù)商下的賬單數(shù)據(jù) 2. 如需下載某個(gè)子商戶下的賬單數(shù)據(jù),則該字段必填 示例值:19000000001 |
https://api.mch.weixin.qq.com/v3/funds-to-oversea/bill-download-url?bill_date=2021-01-01&sub_mchid=19000000001
參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
---|---|---|---|---|
哈希類型 | hash_type | string | 是 |
SHA1:SHA1值,Secure Hash Algorithm 1 示例值:SHA1 |
哈希值 | hash_value | string[1,1024] | 是 | 原始賬單(gzip需要解壓縮)的摘要值,用于校驗(yàn)文件的完整性。 建議將實(shí)際賬單文件的哈希值和該哈希值進(jìn)行比對(duì),以確認(rèn)數(shù)據(jù)的完整性。 示例值:79bb0f45fc4c42234a918000b2668d689e2bde04 |
下載地址 | download_url | string[1,2048] | 是 | 下載地址5min內(nèi)有效 示例值:https://api.mch.weixin.qq.com/v3/bill/downloadurl?token=xxx |
{
"download_url": "https://api.mch.weixin.qq.com/v3/bill/downloadurl?token=xxx",
"hash_type": "SHA1",
"hash_value": "79bb0f45fc4c42234a918000b2668d689e2bde04"
}
狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
---|---|---|---|
403 | NO_AUTH | 商戶無權(quán)限申請(qǐng)資金出境 | 商戶無權(quán)限申請(qǐng)資金出境,請(qǐng)申請(qǐng)相關(guān)權(quán)限 |
400 | PARAM_ERROR | 參數(shù)錯(cuò)誤 | 請(qǐng)求參數(shù)錯(cuò)誤,請(qǐng)重新檢查再調(diào)用查詢剩余可出境余額 |