微信支付-开发者文档

返回上一层文档首页 / 申请分账账单API

申请分账账单API

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

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

注意：

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

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

• 对账单接口只能下载三个月以内的账单。

文件格式说明：

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

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

接口说明

适用对象：电商平台服务商

请求URL：https://api.mch.weixin.qq.com/v3/profitsharing/bills

请求方式：GET

path 指该参数为路径参数

query 指该参数为URL参数

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

请求参数

参数名	变量	类型[长度限制]	必填	描述
子商户号	sub_mchid	string[8, 12]	否	query 不填则默认返回服务商下的所有分账账单。如需下载某个子商户下的分账账单，则填指定的子商户号。示例值：19000000001
账单日期	bill_date	string[10, 10]	是	query 格式yyyy-MM-DD 仅支持三个月内的账单下载申请。示例值：2019-06-11
压缩类型	tar_type	string[1,32]	否	query 不填则默认是数据流枚举值： GZIP：返回格式为.gzip的压缩包账单示例值：GZIP

请求示例


https://api.mch.weixin.qq.com/v3/profitsharing/bills?sub_mchid=19000000001&bill_date=2019-06-11&tar_type=GZIP


｛
JAVA示例代码
｝

返回参数

参数名	变量	类型[长度限制]	必填	描述
下载地址	download_url	string[1, 2048]	是	供下一步请求账单文件的下载地址，该地址30s内有效。示例值：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需要解压缩）的摘要值，用于校验文件的完整性。示例值：79bb0f45fc4c42234a918000b2668d689e2bde04

返回示例

正常示例


{
  "download_url": "https://api.mch.weixin.qq.com/v3/bill/downloadurl?token=xxx",
  "hash_type": "SHA1",
  "hash_value": "79bb0f45fc4c42234a918000b2668d689e2bde04"
}


http://2323weixin.qq.com

错误码公共错误码

状态码	错误码	描述	解决方案
500	SYSTEM_ERROR	系统错误	系统异常，请使用相同参数稍后重新调用
400	PARAM_ERROR	日期格式不正确	请使用正确的参数重新调用
429	RATELIMIT_EXCEEDED	商户发起获取账单的频率过高	请降低频率后重试
400	INVALID_REQUEST	服务商和分账方无受理关系	请检查子商户号是否正确
400	INVALID_REQUEST	请求的账单日期已过期	请调整账单日期
400	INVALID_REQUEST	请求的账单正在生成中	请确认账单时间是否正确，当日的账单会在次日上午10点以后可供下载
400	NO_STATEMENT_EXIST	账单文件不存在	请确认账单时间是否正确，当日的账单会在次日上午10点以后可供下载

微信支付合作伙伴平台