refund_time 、 mch_settle_time 、 refund_amount 、 refund_account 、 after_sale_id 、 commission_fee_settle_time 字段， refund_account 字段新增枚举值# 查询券账单
接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南。
接口英文名：getvoucherbilllist
查询券账单
# 1. 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/channels/ec/voucher/get_bill_list?access_token=ACCESS_TOKEN
# 云调用
- 本接口不支持云调用。
# 第三方调用
本接口支持第三方平台代商家调用。
该接口所属的权限集 id 为：164
服务商获得其中之一权限集授权后，可通过使用 authorizer_access_token 代商家进行调用，具体可查看 第三方调用 说明文档。
# 2. 请求参数
# 查询参数 Query String Parameters
| 参数名 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|
| access_token | string | 是 | ACCESS_TOKEN | 接口调用凭证，可使用 access_token、authorizer_access_token |
# 请求体 Request Payload
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| product_id | string | 是 | 通过本地生活api创建的商品id |
| bill_date | string | 是 | 账单日期，券发起核销时间 |
| page_size | number | 是 | 页大小 值限制: 1 ≤ value ≤ 100 |
| page_ctx | string | 是 | 翻页上下文，第一次请求填空，后续请求值为上次请求的返回 |
# 3. 返回参数
# 返回体 Response Payload
| 参数名 | 类型 | 说明 |
|---|---|---|
| errcode | number | 错误码 |
| errmsg | string | 错误信息 |
| bill_list | objarray | 用户券账单列表 |
| page_ctx | string | 翻页上下文，如果为空，说明没有下一页 |
# Res.bill_list(Array) Object Payload
用户券账单列表
| 参数名 | 类型 | 说明 | 枚举 |
|---|---|---|---|
| voucher_name | string | 商品名称 | - |
| product_id | string | 通过本地生活api创建的商品id | - |
| code | string | 券code | - |
| order_id | string | 购买券的订单ID | - |
| openid | string | 用户在商家品牌appid下的openid | - |
| voucher_buy_time | number | 购买时间 | - |
| voucher_buy_amount | number | 券售卖金额(分)。次卡时为单次金额 | - |
| voucher_pay_amount | number | 用户支付金额(分) 。次卡时为单次金额 | - |
| mch_favor_amount | number | 视频号小店商家优惠减价金额(分)。次卡时为单次金额 | - |
| platform_favor_amount | number | 视频号小店平台优惠减价金额(分)。次卡时为单次金额 | - |
| consume_time | number | 核销时间，时间戳 | - |
| consume_store_name | string | 核销的门店名称（商户在核销券接口传入后才会返回） | - |
| mch_settle_amount | number | 给商家的已结算金额(分)。次卡时为单次金额。 | - |
| finder_settle_amount | number | 给达人的结算金额(分)。次卡时为单次金额 | - |
| out_store_id | string | 核销接口传入out_store_id | - |
| time_index | number | 次序号标识2024年2月底次卡上线后返回 | - |
| refund_time | number | 退款时间, 秒级时间戳 | - |
| mch_settle_time | number | 商家结算时间, 秒级时间戳 | - |
| refund_amount | number | 退款金额(分) | - |
| refund_account | number | 退款账户 | 枚举值 |
| after_sale_id | string | 退款关联的售后单id | - |
| commission_fee_settle_time | number | 佣金结算时间, 秒级时间戳 | - |
# 4. 枚举信息
# Res.bill_list(Array).refund_account Enum
退款账户
| 枚举值 | 描述 |
|---|---|
| 2000 | 可提现账户 |
| 3000 | 保证金账户 |
# 5. 注意事项
单商户限频200QPS
# 6. 代码示例
请求示例
{
"product_id": "123456",
"bill_date": "2023-12-03",
"page_size": 3,
"page_ctx": ""
}
返回示例
{
"errcode": 0,
"errmsg": "成功",
"bill_list":[
{
"voucher_name": "90抵100代金券",
"product_id": "123456",
"code": "123456789",
"order_id": "027828012830384172",
"openid": "asdjeine835k9fjeld93mf"
"voucher_buy_time": 1702016538,
"voucher_buy_amount": 9000,
"voucher_pay_amount": 8500,
"mch_favor_amount": 500,
"platform_favor_amount": 0,
"consume_time": 1702189338,
"consume_store_name": "开心小店",
"mch_settle_amount": 8300,
"finder_settle_amount": 0
},
{
"voucher_name": "90抵100代金券",
"product_id": "123456",
"code": "123456789",
"order_id": "027828012830384172",
"openid": "asdjeine835k9fjeld93mf"
"voucher_buy_time": 1702016538,
"voucher_buy_amount": 9000,
"voucher_pay_amount": 8500,
"mch_favor_amount": 500,
"platform_favor_amount": 0,
"consume_time": 1702189338,
"consume_store_name": "开心小店",
"mch_settle_amount": 8300,
"finder_settle_amount": 0
},
{
"voucher_name": "90抵100代金券",
"product_id": "123456",
"code": "123456789",
"order_id": "027828012830384172",
"openid": "asdjeine835k9fjeld93mf"
"voucher_buy_time": 1702016538,
"voucher_buy_amount": 9000,
"voucher_pay_amount": 8500,
"mch_favor_amount": 500,
"platform_favor_amount": 0,
"consume_time": 1702189338,
"consume_store_name": "开心小店",
"mch_settle_amount": 8300,
"finder_settle_amount": 0
}],
"page_ctx": "dsfajasdlf3434"
}
# 7. 错误码
此接口没有特殊错误码，可参考 通用错误码；调用接口遇到报错，可使用官方提供的 API 诊断工具 辅助定位和分析问题。
# 8. 适用范围
本接口支持「微信小店」账号类型调用。其他账号类型如无特殊说明，均不可调用。
接口变更日志（1条）2026 年 05 月 09 日
新增