獲取分賬賬單文件下載地址API
最新更新時間：2023.10.20 版本說明
微信支付按天提供分賬賬單文件，商戶可以通過該接口獲取賬單文件的下載地址。文件內(nèi)包含分賬相關(guān)的金額、時間等信息，供商戶核對到賬等情況。
注意： ? 微信側(cè)未成功的分賬單不會出現(xiàn)在對賬單中；
? 對賬單中涉及金額的字段單位為“元”。
? 分賬對賬單接口只支持下載90天以內(nèi)的賬單
注意： 1. 接口說明
適用對象：直連模式 機構(gòu)模式
請求URL：https://apihk.mch.weixin.qq.com/v3/global/profit-sharing/bill-download-url
請求方式：GET
Path指該參數(shù)為路徑參數(shù)
Query指該參數(shù)為URL參數(shù)
Body指該參數(shù)需在請求JSON傳參
2. 請求參數(shù)
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 二級商戶號 | sub_mchid | string[1, 32] | 否 | Query若商戶是直連商戶：無需填寫該字段。 若商戶是服務(wù)商/機構(gòu)：必填，填寫需要下載賬單的對應(yīng)二級商戶號。 示例值：19000000001 |
| 賬單日期 | bill_date | string[10, 10] | 是 | Query格式y(tǒng)yyy-MM-DD 分賬對賬單接口只支持下載90天以內(nèi)的賬單 示例值：2020-01-01 |
請求示例
https://apihk.mch.weixin.qq.com/v3/global/profit-sharing/bill-download-url?sub_mchid=19000000001&bill_date=2020-01-013. 返回參數(shù)
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 下載地址 | download_url | string[1, 2048] | 是 | 供下一步請求賬單文件的下載地址，該地址30s內(nèi)有效 示例值：https://apihk.mch.weixin.qq.com/v3/bill/downloadurl?token=xxx |
返回示例
{
"download_url": "https://apihk.mch.weixin.qq.com/v3/bill/downloadurl?token=xxx"
}文件格式說明
? 賬單文件包括明細數(shù)據(jù)和匯總數(shù)據(jù)兩部分，每一部分都包含一行表頭和若干行具體數(shù)據(jù)；
? 明細數(shù)據(jù)每一行對應(yīng)一筆分賬，同時每一個數(shù)據(jù)前加入了字符`，以避免數(shù)據(jù)被Excel按科學(xué)計數(shù)法處理。如需匯總金額等數(shù)據(jù)，可以批量替換掉該字符。
? 數(shù)據(jù)頭的格式為：create_time,initiator,sponsor,sub_mchid,transaction_id,order_id,out_order_no,detaill_id,receiver_account,amount,currency,
settlement_amount,settlement_currency,exchange_rate,business_type,status,description; 對應(yīng)的含義見下表：
| 變量 | 字段名 | 描述 |
|---|---|---|
| create_time | 分賬發(fā)起時間 | 商戶請求該筆分賬/系統(tǒng)發(fā)起逾期解凍的系統(tǒng)受理時間 |
| initiator | 分賬發(fā)起方 | 若為商戶發(fā)起，則為發(fā)起方商戶號; 若為系統(tǒng)發(fā)起，則為"system" |
| sponsor | 分賬出資方 | 實際出資的商戶號，同結(jié)算入賬商戶 |
| sub_mchid | 二級商戶號 | 該筆分賬對應(yīng)交易訂單的二級商戶號 |
| transaction_id | 微信支付訂單號 | 帶有分賬標(biāo)記的微信支付訂單號 |
| order_id | 微信分賬單號 | 請求分賬時，微信返回給商戶的分賬單號 |
| out_order_no | 商戶分賬單號 | 商戶請求分賬時，傳入的商戶分賬單號；若為系統(tǒng)發(fā)起的逾期解凍指令，則該字段為空 |
| detaill_id | 微信分賬明細單號 | 該筆分賬對應(yīng)的轉(zhuǎn)賬明細單號，對應(yīng)商戶請求分賬時的某個接收方收款 |
| receiver_account | 分賬接收方賬戶 | 分出時接收方賬戶，若為解凍購匯(business_type=TO_SPONSOR)時則為空 |
| amount | 分賬金額 | 該筆分賬明細子單的實際分賬金額 |
| currency | 分賬幣種 | |
| settlement_amount | 解凍出境金額 | 只有解凍出境購匯(business_type=TO_SPONSOR)才有 |
| settlement_currency | 結(jié)算幣種 | 只有解凍出境購匯(business_type=TO_SPONSOR)才有 |
| exchange_rate | 匯率 | 只有解凍出境購匯(business_type=TO_SPONSOR)才有 |
| business_type | 業(yè)務(wù)類型 | 分出：TO_ACCEPTOR；解凍出境：TO_SPONSOR |
| status | 處理狀態(tài) | "SUCCESS"，目前只有成功的單據(jù)才出賬單 |
| description | 分賬描述 | 商戶傳入的分賬描述內(nèi)容；若為系統(tǒng)發(fā)起逾期解凍，則為"Unfreeze the remaining funds to sponsor" |
? 匯總頭的格式為：total_count,total_amount_to_sponsor,total_amount_to_acceptor；對應(yīng)的含義為：賬單總條數(shù)，當(dāng)天解凍總金額，當(dāng)天分出總金額；
? 數(shù)據(jù)行和匯總頭之間有空行。
create_time,initiator,sponsor,sub_mchid,transaction_id,order_id,out_order_no,detaill_id,receiver_account,amount,currency,settlement_amount,settlement_currency,exchange_rate,business_type,status,description
`2020-08-01 15:19:53,`1489578022,`1489578022,`1489578025,`4200001201202111086372797299,`7100010010202111091636447398824,`HX3804579307200708608,`7200010010202111091636447398823,`,`80.38,`CNY,`16.40,`AUD,`490176891,`TO_SPONSOR,`SUCCESS,`Unfreeze the remaining funds to sponsor
total_count,total_amount_to_sponsor,total_amount_to_acceptor
`1,`80.38,`0
4. 錯誤碼
| 狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 400 | NO_STATEMENT_EXIST | 請求的賬單文件不存在 | 請檢查當(dāng)前商戶號是否在指定日期有處理成功的分賬指令單 |
| 400 | STATEMENT_CREATING | 賬單生成中 | 請先檢查當(dāng)前商戶號在指定日期內(nèi)是否有處理成功的分賬指令單，若有，則在T+1日上午10點后再重新下載 |
| 403 | NO_AUTH | 商戶父子關(guān)系不存在，請使用正確的二級商戶號發(fā)起請求 | 請檢查二級商戶號(sub_mchid)是否填寫正確 |
| 403 | NO_AUTH | 商戶未簽約境外分賬產(chǎn)品能力 | 請參考產(chǎn)品流程和接入準(zhǔn)備，確認商戶具有分賬權(quán)限后再發(fā)起請求 |
| 403 | NO_AUTH | 商戶已開通分賬產(chǎn)品能力，等待生效中(一般為第二天才生效) | 開通分賬產(chǎn)品能力當(dāng)天不能發(fā)起分賬，請等待第二天后發(fā)起請求 |
頁面導(dǎo)航
