最新更新時(shí)間:2022.04.11 版本說(shuō)明
微信支付按天提供分賬賬單文件,商戶可以通過(guò)該接口獲取賬單文件的下載地址。文件內(nèi)包含分賬相關(guān)的金額、時(shí)間等信息,供商戶核對(duì)到賬等情況。
? 微信側(cè)未成功的分賬單不會(huì)出現(xiàn)在對(duì)賬單中;
? 對(duì)賬單中涉及金額的字段單位為“元”。
適用對(duì)象:直連模式 機(jī)構(gòu)模式
請(qǐng)求URL:https://apihk.mch.weixin.qq.com/v3/global/profit-sharing/bill-download-url
請(qǐng)求方式:get
path 指該參數(shù)為路徑參數(shù)
query 指該參數(shù)為URL參數(shù)
body 指該參數(shù)需在請(qǐng)求JSON傳參
參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
---|---|---|---|---|
二級(jí)商戶號(hào) | sub_mchid | string[1, 32] | 否 | query若商戶是直連商戶:無(wú)需填寫(xiě)該字段。 若商戶是服務(wù)商/機(jī)構(gòu):必填,填寫(xiě)需要下載賬單的對(duì)應(yīng)二級(jí)商戶號(hào)。 示例值:19000000001 |
賬單日期 | bill_date | string[10, 10] | 是 | query格式y(tǒng)yyy-MM-DD 示例值:2020-01-01 |
https://api.mch.weixin.qq.com/v3/global/profit-sharing/bill-download-url?sub_mchid=19000000001&bill_date=2020-01-01
參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
---|---|---|---|---|
下載地址 | download_url | string[1, 2048] | 是 | 供下一步請(qǐng)求賬單文件的下載地址,該地址30s內(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"
}
? 賬單文件包括明細(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ù),可以批量替換掉該字符。
? 數(shù)據(jù)頭的格式為:create_time,initiator,sponsor,sub_mchid,transaction_id,order_id,out_order_no,detail_id,receiver_account,amount,currency,
settlement_amount,settlement_currency,exchange_rate,business_type,status,description; 對(duì)應(yīng)的含義見(jiàn)下表:
變量 | 字段名 | 描述 |
---|---|---|
create_time | 分賬發(fā)起時(shí)間 | 商戶請(qǐng)求該筆分賬/系統(tǒng)發(fā)起逾期解凍的系統(tǒng)受理時(shí)間 |
initiator | 分賬發(fā)起方 | 若為商戶發(fā)起,則為發(fā)起方商戶號(hào); 若為系統(tǒng)發(fā)起,則為"system" |
sponsor | 分賬出資方 | 實(shí)際出資的商戶號(hào),同結(jié)算入賬商戶 |
sub_mchid | 二級(jí)商戶號(hào) | 該筆分賬對(duì)應(yīng)交易訂單的二級(jí)商戶號(hào) |
transaction_id | 微信支付訂單號(hào) | 帶有分賬標(biāo)記的微信支付訂單號(hào) |
order_id | 微信分賬單號(hào) | 請(qǐng)求分賬時(shí),微信返回給商戶的分賬單號(hào) |
out_order_no | 商戶分賬單號(hào) | 商戶請(qǐng)求分賬時(shí),傳入的商戶分賬單號(hào);若為系統(tǒng)發(fā)起的逾期解凍指令,則該字段為空 |
detail_id | 微信分賬明細(xì)單號(hào) | 該筆分賬對(duì)應(yīng)的轉(zhuǎn)賬明細(xì)單號(hào),對(duì)應(yīng)商戶請(qǐng)求分賬時(shí)的某個(gè)接收方收款 |
receiver_account | 分賬接收方賬戶 | 分出時(shí)接收方賬戶,若為解凍購(gòu)匯(business_type=TO_SPONSOR)時(shí)則為空 |
amount | 分賬金額 | 該筆分賬明細(xì)子單的實(shí)際分賬金額 |
currency | 分賬幣種 | |
settlement_amount | 解凍出境金額 | 只有解凍出境購(gòu)匯(business_type=TO_SPONSOR)才有 |
settlement_currency | 結(jié)算幣種 | 只有解凍出境購(gòu)匯(business_type=TO_SPONSOR)才有 |
exchange_rate | 匯率 | 只有解凍出境購(gòu)匯(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;對(duì)應(yīng)的含義為:賬單總條數(shù),當(dāng)天解凍總金額,當(dāng)天分出總金額;
? 數(shù)據(jù)行和匯總頭之間有空行。
create_time,initiator,sponsor,sub_mchid,transaction_id,order_id,out_order_no,detail_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
狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
---|---|---|---|
400 | NO_STATEMENT_EXIST | 請(qǐng)求的賬單文件不存在 | 請(qǐng)檢查當(dāng)前商戶號(hào)是否在指定日期有處理成功的分賬指令單 |
400 | STATEMENT_CREATING | 賬單生成中 | 請(qǐng)先檢查當(dāng)前商戶號(hào)在指定日期內(nèi)是否有處理成功的分賬指令單,若有,則在T+1日上午10點(diǎn)后再重新下載 |
403 | NO_AUTH | 商戶父子關(guān)系不存在,請(qǐng)使用正確的二級(jí)商戶號(hào)發(fā)起請(qǐng)求 | 請(qǐng)檢查二級(jí)商戶號(hào)(sub_mchid)是否填寫(xiě)正確 |
403 | NO_AUTH | 商戶未簽約境外分賬產(chǎn)品能力 | 請(qǐng)參考產(chǎn)品流程和接入準(zhǔn)備,確認(rèn)商戶具有分賬權(quán)限后再發(fā)起請(qǐng)求 |
403 | NO_AUTH | 商戶已開(kāi)通分賬產(chǎn)品能力,等待生效中(一般為第二天才生效) | 開(kāi)通分賬產(chǎn)品能力當(dāng)天不能發(fā)起分賬,請(qǐng)等待第二天后發(fā)起請(qǐng)求 |
Customer Service Tel
Business Development
9:00-18:00
Monday-Friday GMT+8
Technical Support
WeChat Pay Global
ICP證