最新更新時(shí)間:2021.07.22 版本說(shuō)明
微信支付按天提供分賬賬單文件,商戶可以通過(guò)該接口獲取賬單文件的下載地址。文件內(nèi)包含分賬相關(guān)的金額、時(shí)間等信息,供商戶核對(duì)到賬等情況。
? 微信側(cè)未成功的分賬單不會(huì)出現(xiàn)在對(duì)賬單中。
? 對(duì)賬單中涉及金額的字段單位為“元”。
? 對(duì)賬單接口只能下載三個(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ù),可以批量替換掉該字符。
適用對(duì)象:電商平臺(tái) 服務(wù)商
請(qǐng)求URL:https://api.mch.weixin.qq.com/v3/profitsharing/bills
請(qǐng)求方式:GET
path 指該參數(shù)為路徑參數(shù)
query 指該參數(shù)為URL參數(shù)
body 指該參數(shù)需在請(qǐng)求JSON傳參
參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
---|---|---|---|---|
子商戶號(hào) | sub_mchid | string[8, 12] | 否 | query
不填則默認(rèn)返回服務(wù)商下的所有分賬賬單。 如需下載某個(gè)子商戶下的分賬賬單,則填指定的子商戶號(hào)。 示例值:19000000001 |
賬單日期 | bill_date | string[10, 10] | 是 | query 格式y(tǒng)yyy-MM-DD 僅支持三個(gè)月內(nèi)的賬單下載申請(qǐng)。 示例值:2019-06-11 |
壓縮類型 | tar_type | string[1,32] | 否 | query 不填則默認(rèn)是數(shù)據(jù)流 枚舉值: GZIP:返回格式為.gzip的壓縮包賬單 示例值:GZIP |
https://api.mch.weixin.qq.com/v3/profitsharing/bills?sub_mchid=19000000001&bill_date=2019-06-11&tar_type=GZIP
參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
---|---|---|---|---|
下載地址 | download_url | string[1, 2048] | 是 | 供下一步請(qǐng)求賬單文件的下載地址,該地址30s內(nèi)有效。 示例值:https://api.mch.weixin.qq.com/v3/bill/downloadurl?token=xxx |
哈希類型 | hash_type | string[1,32] | 是 | 枚舉值: SHA1:SHA1值 示例值:SHA1 |
哈希值 | hash_value | string[1, 1024] | 是 | 原始賬單(gzip需要解壓縮)的摘要值,用于校驗(yàn)文件的完整性。 示例值:79bb0f45fc4c42234a918000b2668d689e2bde04 |
{
"download_url": "https://api.mch.weixin.qq.com/v3/bill/downloadurl?token=xxx",
"hash_type": "SHA1",
"hash_value": "79bb0f45fc4c42234a918000b2668d689e2bde04"
}
狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
---|---|---|---|
500 | SYSTEM_ERROR | 系統(tǒng)錯(cuò)誤 | 系統(tǒng)異常,請(qǐng)使用相同參數(shù)稍后重新調(diào)用 |
400 | PARAM_ERROR | 日期格式不正確 | 請(qǐng)使用正確的參數(shù)重新調(diào)用 |
429 | RATELIMIT_EXCEEDED | 商戶發(fā)起獲取賬單的頻率過(guò)高 | 請(qǐng)降低頻率后重試 |
400 | INVALID_REQUEST | 服務(wù)商和分賬方無(wú)受理關(guān)系 | 請(qǐng)檢查子商戶號(hào)是否正確 |
400 | INVALID_REQUEST | 請(qǐng)求的賬單日期已過(guò)期 | 請(qǐng)調(diào)整賬單日期 |
400 | INVALID_REQUEST | 請(qǐng)求的賬單正在生成中 | 請(qǐng)確認(rèn)賬單時(shí)間是否正確,當(dāng)日的賬單會(huì)在次日上午10點(diǎn)以后可供下載 |
400 | NO_STATEMENT_EXIST | 賬單文件不存在 | 請(qǐng)確認(rèn)賬單時(shí)間是否正確,當(dāng)日的賬單會(huì)在次日上午10點(diǎn)以后可供下載 |