申请分账账单
更新时间:2024.01.17微信支付按天提供分账账单文件,商户可以通过该接口获取账单文件的下载地址。文件内包含分账相关的金额、时间等信息,供商户核对到账等情况。
- 微信侧未成功的分账单不会出现在对账单中。
- 对账单中涉及金额的字段单位为“元”;
- 对账单接口只能下载三个月以内的账单。
- 账单文件包括明细数据和汇总数据两部分,每一部分都包含一行表头和若干行具体数据。
- 明细数据每一行对应一笔分账或一笔回退,同时每一个数据前加入了字符`,以避免数据被Excel按科学计数法处理。如需汇总金额等数据,可以批量替换掉该字符。
# 接口说明
支持商户:
【普通服务商】
请求方式:
【GET】/v3/profitsharing/bills
请求域名:
【主域名】
https://api.mch.weixin.qq.com
使用该域名将访问就近的接入点【备域名】
https://api2.mch.weixin.qq.com
使用该域名将访问异地的接入点 ,指引点击查看
# 请求参数
- Authorization 必填请参考 签名认证 生成认证信息
- Accept 必填请设置为
application/json
Header HTTP头参数
- sub_mchid 选填【子商户号】 若商户是直连商户:
- 无需填写该字段
若商户是服务商:
- 不填则默认返回服务商下的所有分账账单。
- 如需下载某个子商户下的分账账单,则填指定的子商户号。 - bill_date 必填【账单日期】 格式YYYY-MM-DD。仅支持三个月内的账单下载申请。
- tar_type 选填【压缩类型】 不填则以不压缩的方式返回数据流
可选取值:GZIP
: 返回格式为.gzip的压缩包账单
Query 查询参数
请求示例
GET
# 应答参数
- hash_type 必填【哈希类型】 原始账单(gzip需要解压缩)的摘要算法,用于校验文件的完整性
可选取值:SHA1
: Secure Hash Algorithm 1
- hash_value 必填【哈希值】 原始账单(gzip需要解压缩)的摘要值,用于校验文件的完整性
- download_url 必填【下载地址】 供下一步请求账单文件的下载地址,该地址30s内有效
200OK
应答示例
200 OK
# 错误码
# 公共错误码
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
400 | PARAM_ERROR | 参数错误 | 请根据错误提示正确传入参数 |
400 | INVALID_REQUEST | HTTP 请求不符合微信支付 APIv3 接口规则 | 请参阅 接口规则 |
401 | SIGN_ERROR | 验证不通过 | 请参阅 签名常见问题 |
500 | SYSTEM_ERROR | 系统异常,请稍后重试 | 请稍后重试 |
# 业务错误码
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
400 | INVALID_REQUEST | 服务商和分账方无受理关系 | 请检查子商户号是否正确 |
400 | INVALID_REQUEST | 请求的账单日期已过期 | 请调整账单日期 |
400 | INVALID_REQUEST | 请求的账单正在生成中 | 请确认账单时间是否正确,当日的账单会在次日上午10点以后可供下载 |
400 | NO_STATEMENT_EXIST | 账单文件不存在 | 请确认账单时间是否正确,当日的账单会在次日上午10点以后可供下载 |
400 | PARAM_ERROR | 日期格式不正确 | 请使用正确的参数重新调用 |
429 | RATELIMIT_EXCEED | 商户发起获取账单的频率过高 | 请降低频率后重试 |
500 | SYSTEM_ERROR | 系统错误 | 系统异常,请使用相同参数稍后重新调用 |
文档是否有帮助