# 接口下载交易账单与资金账单

接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南。

接口英文名：downLoadBill

该接口支持查询近 90 天内的账单。

# 后台页面下载交易账单

平台后台页面，提供交易查询、退款查询、以及下载账单能力。

# 1. 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/retail/B2b/downloadbill?access_token=ACCESS_TOKEN

# 云调用

• 本接口不支持云调用。

# 第三方调用

• 本接口支持第三方平台代商家调用。

• 该接口所属的权限集 id 为：158

• 服务商获得其中之一权限集授权后，可通过使用 authorizer_access_token 代商家进行调用，具体可查看 第三方调用 说明文档。

# 2. 请求参数

# 查询参数 Query String Parameters

# 请求体 Request Payload

# 3. 返回参数

# 返回体 Response Payload

# 4. 注意事项

# 说明

1. 下载链接是https的接口，获取后30min有效

2. 下载后的交易账单文件内容说明：

   a. 文件中的内容是以csv文件格式返回，第一行为表头

   b. 从第二行起，为数据记录，各参数值以逗号分隔，参数值前增加`符号，为标准键盘1左边键的字符

   c. 表头字段顺序与说明：

3. 下载后的资金账单文件内容说明： ​ a. 资金账单是针对账户整体（包括可提现部分与待结算部分之和）的资金流入流出变动情况

   ​ b. 文件中的内容是以csv文件格式返回，第一行为表头

   ​ c. 从第二行起，为数据记录，各参数值以逗号分隔，参数值前增加`符号，为标准键盘1左边键的字符

   ​ d. 表头字段顺序与说明：

其中，业务名称、业务类型、收支类型有这几种情况：

# 账单说明

1）技术服务费说明

每笔交易收取的技术服务费=订单金额x技术服务费费率，保留到单位分，最后一位小数按四舍五入。

2）退款返还技术服务费说明

对于退款，平台将根据退款金额返还相关技术服务费。

退款的返还技术服务费规则：

1. 如果为全额退款，则全部返还原来收取的技术服务费；
3. 如果为部分退款，按0.22%计算后保留到单位分，最后一位小数按向下取整（如计算出来返还0.238，实际只返还0.23）
5. 如果经过多笔部分退款后，最后一笔变成全额退款，则最终返还技术服务费的总金额=原来收取的技术服务费

# 5. 代码示例

请求示例

{
    "mchid": "",
    "bill_date": "20231102"
}

返回示例

{
    "errcode": 0,
    "errmsg": "",
    "success_bill_url": "",
    "refund_bill_url": "",
    "all_bill_url": "",
    "fund_bill_url": "",
    "ended_day_avail_amt": 0,
    "ended_day_frozen_amt": 0,
    "ended_day_total_amt": 0,
    "profit_sharing_bill_url": "",
    "profit_refund_bill_url": "",
    "bankpay_fund_bill_url": ""
}

# 6. 错误码

以下是本接口的错误码列表，其他错误码可参考 通用错误码；调用接口遇到报错，可使用官方提供的 API 诊断工具 辅助定位和分析问题。

# 7. 适用范围

本接口暂未明确可调用账号类型，或在业务中根据调用传参自行确定是否可调用，请以实际调用情况为准。