获取分账账单文件下载地址

更新时间：2025.01.07

微信支付按天提供分账账单文件，商户可以通过该接口获取账单文件的下载地址。文件内包含分账相关的金额、时间等信息，供商户核对到账等情况。

注意：

微信侧未成功的分账单不会出现在对账单中；

对账单中涉及金额的字段单位为“元”。

分账对账单接口只支持下载90天以内的账单

1. 接口说明

适用对象：直连模式机构模式

请求URL：https://apihk.mch.weixin.qq.com/v3/global/profit-sharing/bill-download-url

请求方式：GET

Path 指该参数为路径参数

Query 指该参数为URL参数

Body 指该参数需在请求JSON传参

2. 请求参数

参数名	变量	类型[长度限制]	必填	描述
二级商户号	sub_mchid	string[1, 32]	否	Query 若商户是直连商户：无需填写该字段。若商户是服务商/机构：必填，填写需要下载账单的对应二级商户号。示例值：19000000001
账单日期	bill_date	string[10, 10]	是	Query 格式yyyy-MM-DD 分账对账单接口只支持下载90天以内的账单示例值：2020-01-01

请求示例

URL

1https://apihk.mch.weixin.qq.com/v3/global/profit-sharing/bill-download-url?sub_mchid=19000000001&bill_date=2020-01-01

3. 返回参数

参数名	变量	类型[长度限制]	必填	描述
下载地址	download_url	string[1, 2048]	是	供下一步请求账单文件的下载地址，该地址30s内有效示例值：https://apihk.mch.weixin.qq.com/v3/bill/downloadurl?token=xxx

返回示例

正常示例

1{
2  "download_url": "https://apihk.mch.weixin.qq.com/v3/bill/downloadurl?token=xxx"
3}

文件格式说明

账单文件包括明细数据和汇总数据两部分，每一部分都包含一行表头和若干行具体数据；

明细数据每一行对应一笔分账，同时每一个数据前加入了字符`，以避免数据被Excel按科学计数法处理。如需汇总金额等数据，可以批量替换掉该字符。

数据头的格式为：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; 对应的含义见下表：

变量	字段名	描述
create_time	分账发起时间	商户请求该笔分账/系统发起逾期解冻的系统受理时间
initiator	分账发起方	若为商户发起，则为发起方商户号; 若为系统发起，则为"system"
sponsor	分账出资方	实际出资的商户号，同结算入账商户
sub_mchid	二级商户号	该笔分账对应交易订单的二级商户号
transaction_id	微信支付订单号	带有分账标记的微信支付订单号
order_id	微信分账单号	请求分账时，微信返回给商户的分账单号
out_order_no	商户分账单号	商户请求分账时，传入的商户分账单号；若为系统发起的逾期解冻指令，则该字段为空
detaill_id	微信分账明细单号	该笔分账对应的转账明细单号，对应商户请求分账时的某个接收方收款
receiver_account	分账接收方账户	分出时接收方账户，若为解冻购汇(business_type=TO_SPONSOR)时则为空
amount	分账金额	该笔分账明细子单的实际分账金额
currency	分账币种
settlement_amount	解冻出境金额	只有解冻出境购汇(business_type=TO_SPONSOR)才有
settlement_currency	结算币种	只有解冻出境购汇(business_type=TO_SPONSOR)才有
exchange_rate	汇率	只有解冻出境购汇(business_type=TO_SPONSOR)才有
business_type	业务类型	分出：TO_ACCEPTOR；解冻出境：TO_SPONSOR
status	处理状态	"SUCCESS"，目前只有成功的单据才出账单
description	分账描述	商户传入的分账描述内容；若为系统发起逾期解冻，则为"Unfreeze the remaining funds to sponsor"

汇总头的格式为：total_count,total_amount_to_sponsor,total_amount_to_acceptor；对应的含义为：账单总条数，当天解冻总金额，当天分出总金额；

数据行和汇总头之间有空行。

账单内容示例

1create_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
2`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
3
4total_count,total_amount_to_sponsor,total_amount_to_acceptor
5`1,`80.38,`0

4. 错误码

状态码	错误码	描述	解决方案
400	NO_STATEMENT_EXIST	请求的账单文件不存在	请检查当前商户号是否在指定日期有处理成功的分账指令单
400	STATEMENT_CREATING	账单生成中	请先检查当前商户号在指定日期内是否有处理成功的分账指令单，若有，则在T+1日上午10点后再重新下载
403	NO_AUTH	商户父子关系不存在，请使用正确的二级商户号发起请求	请检查二级商户号(sub_mchid)是否填写正确
403	NO_AUTH	商户未签约境外分账产品能力	请参考产品流程和接入准备，确认商户具有分账权限后再发起请求
403	NO_AUTH	商户已开通分账产品能力，等待生效中(一般为第二天才生效)	开通分账产品能力当天不能发起分账，请等待第二天后发起请求