申请分账账单

更新时间:2024.01.17

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

  1. 微信侧未成功的分账单不会出现在对账单中。
  2. 对账单中涉及金额的字段单位为“元”;
  3. 对账单接口只能下载三个月以内的账单。
  4. 账单文件包括明细数据和汇总数据两部分,每一部分都包含一行表头和若干行具体数据。
  5. 明细数据每一行对应一笔分账或一笔回退,同时每一个数据前加入了字符`,以避免数据被Excel按科学计数法处理。如需汇总金额等数据,可以批量替换掉该字符。

# 接口说明

支持商户:
【普通服务商】
请求方式:
【GET】/v3/profitsharing/bills
请求域名:
【主域名】
https://api.mch.weixin.qq.com
使用该域名将访问就近的接入点
【备域名】
https://api2.mch.weixin.qq.com
使用该域名将访问异地的接入点 ,指引点击查看

# 请求参数

    Header HTTP头参数
  • Authorization 必填 string
    请参考 签名认证 生成认证信息
  • Accept 必填 string
    请设置为 application/json
    Query 查询参数
  • sub_mchid 选填 string(12)
    【子商户号】 若商户是直连商户:
    - 无需填写该字段
    若商户是服务商:
    - 不填则默认返回服务商下的所有分账账单。
    - 如需下载某个子商户下的分账账单,则填指定的子商户号。
  • bill_date 必填 string(10)
    【账单日期】 格式YYYY-MM-DD。仅支持三个月内的账单下载申请。
  • tar_type 选填 string
    【压缩类型】 不填则以不压缩的方式返回数据流
    可选取值:
    • GZIP: 返回格式为.gzip的压缩包账单

请求示例

GET

# 应答参数

    200OK
  • hash_type 必填 string
    【哈希类型】 原始账单(gzip需要解压缩)的摘要算法,用于校验文件的完整性
    可选取值:
    • SHA1: Secure Hash Algorithm 1
  • hash_value 必填 string(1024)
    【哈希值】 原始账单(gzip需要解压缩)的摘要值,用于校验文件的完整性
  • download_url 必填 string(2048)
    【下载地址】 供下一步请求账单文件的下载地址,该地址30s内有效

应答示例

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 系统错误 系统异常,请使用相同参数稍后重新调用
反馈
咨询
目录