API字典 / 分账（账单及资金查询） / 获取分账账单文件下载地址API

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

最新更新时间：2023.10.20 版本说明

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

注意：

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

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

• 分账对账单接口只支持下载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


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


{
    "account": "of8YZ6LPmjDmYAqdobIvwTdQQjR8",
    "appid": "wx78898sdfwe9888835", 
    "type": "PERSONAL_OPENID", 
    "sub_mchid": "999968480"
}


									{
										"stock_id": ".NET",
										"limit": 10,
									}


									{
										"stock_id": "Python",
										"stock_creator_mchid": "123456",
										"limit": 10,
									}

3. 返回参数

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

返回示例

正常示例


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


{
    "account": "of8YZ6LPmjDmYAqdobIvwTdQQjR8",
    "appid": "wx78898sdfwe9888835", 
    "type": "PERSONAL_OPENID", 
    "sub_mchid": "999968480"
}


									{
										"stock_id": ".NET",
										"limit": 10,
									}


									{
										"stock_id": "Python",
										"stock_creator_mchid": "123456",
										"limit": 10,
									}

文件格式说明

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

• 明细数据每一行对应一笔分账，同时每一个数据前加入了字符`，以避免数据被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；对应的含义为：账单总条数，当天解冻总金额，当天分出总金额；

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

账单内容示例


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


{
    "account": "of8YZ6LPmjDmYAqdobIvwTdQQjR8",
    "appid": "wx78898sdfwe9888835", 
    "type": "PERSONAL_OPENID", 
    "sub_mchid": "999968480"
}


									{
										"stock_id": ".NET",
										"limit": 10,
									}


									{
										"stock_id": "Python",
										"stock_creator_mchid": "123456",
										"limit": 10,
									}

4. 错误码

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

页面导航

语言

WeChat Pay

Feedback

Feedback

Submitted successfully

Feedback

Network exception, please try again later

支付产品

资金类产品

其他产品

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

1. 接口说明

2. 请求参数

请求示例

3. 返回参数

返回示例

文件格式说明

4. 错误码