---
url: "https://pay.weixin.qq.com/doc/v3/partner/4015781546.md"
title: "查询批次关联门店列表"
doc_id: 4015781546
---

>更新时间：2025.10.21

服务商可以通过该接口分页查询商品券批次所关联的门店列表

前置条件：

1. 批次的 `store_scope` 为 `SPECIFIC`

2. 批次未失效或过期





## 接口说明

支持商户：【普通服务商】

请求方式：【GET】 `/v3/marketing/partner/product-coupon/product-coupons/{product_coupon_id}/stocks/{stock_id}/associated-stores`

请求域名：【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

　　　　　【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点，指引[点击查看](https://pay.weixin.qq.com/doc/v3/merchant/4012075113.md)

接口限频：20/秒（商户号维度）

## 请求参数

### Header 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| Authorization | string | true | 请参考 [签名认证](https://pay.weixin.qq.com/doc/v3/merchant/4012365342.md#%E8%AF%B7%E6%B1%82%E6%8E%A5%E5%8F%A3%E5%90%8E%E7%AB%AF%E7%AD%BE%E5%90%8D) 生成认证信息 |
| Accept | string | true | 请设置为 `application/json` |
### Path 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| product_coupon_id | string | true | 【商品券ID】 商品券的唯一标识， [创建商品券](https://pay.weixin.qq.com/doc/v3/partner/4015781289.md) 时由微信支付生成 |
| stock_id | string | true | 【批次ID】 商品券批次的唯一标识，商品券批次创建时由微信支付生成（可使用【 [创建商品券API](https://pay.weixin.qq.com/doc/v3/partner/4015781289.md)】或【 [添加商品券批次API](https://pay.weixin.qq.com/doc/v3/partner/4015781304.md)】创建），请确保该批次属于 `product_coupon_id` 对应的商品券 |
### Query 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| page_size | integer | false | 【分页大小】 单次拉取的数据条数上限，不填默认为20，最大值200 |
| page_token | string | false | 【分页Token】 分页查询时，需要传入上一次调用返回的 `next_page_token`，首次调用不填 |
| brand_id | string | true | 【品牌ID】 微信支付为品牌方分配的唯一标识，该品牌应与服务商存在授权关系 |
## 应答参数

200 OK

| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| total_count | integer | false | 【总个数】 批次关联的门店总数，当且仅当 `page_token` 为空时提供 |
| store_list | array[object] | false | 【门店列表】 批次关联的门店列表 |
| store_list.store_id | string | true | 【门店ID】 门店的唯一标识，调用【 [创建品牌门店API](https://pay.weixin.qq.com/doc/v3/partner/4015783183.md)】时由微信支付生成 |
| next_page_token | string(100) | false | 【下一页Token】 分页查询时，如果还有更多数据，会返回下一页的Token，请在下一次查询时设置在 `page_token` 中；如果已无更多数据，则不返回此字段。 |
## 错误码

以下是本接口返回的错误码列表。详细错误码规则，请参考[微信支付接口规则-错误码和错误提示](https://pay.weixin.qq.com/doc/v3/partner/4012081726.md#%E9%94%99%E8%AF%AF%E7%A0%81%E5%92%8C%E9%94%99%E8%AF%AF%E6%8F%90%E7%A4%BA)

| 状态码 | 错误码 | 描述 | 解决方案 |
| --- | --- | --- | --- |
| 400 | PARAM\_ERROR | 参数错误 | 请根据错误提示正确传入参数 |
| 400 | INVALID\_REQUEST | HTTP 请求不符合微信支付 APIv3 接口规则 | 请参阅 [接口规则](https://pay.weixin.qq.com/doc/v3/merchant/4012081709.md) |
| 401 | SIGN\_ERROR | 验证不通过 | 请参阅 [签名常见问题](https://pay.weixin.qq.com/doc/v3/merchant/4012072670.md) |
| 500 | SYSTEM\_ERROR | 系统异常，请稍后重试 | 请稍后重试 |
| 400 | INVALID\_REQUEST | 已过期的批次不可查询关联门店 | 请确认批次是否处于有效期 |
| 400 | INVALID\_REQUEST | 只有 store\_scope 为 SPECIFIC 的批次可以查询关联门店 | 请确认批次 store\_scope 为 SPECIFIC 再调用本接口 |
| 404 | NOT\_FOUND | 未找到 product\_coupon\_id 对应的商品券 | 请确认 product\_coupon\_id 存在且属于当前品牌 |
| 404 | NOT\_FOUND | 未找到 stock\_id 对应的商品券批次 | 请确认 stock\_id 存在且属于当前商品券 |
| 429 | RATELIMIT\_EXCEEDED | 请求超过接口频率限制 | 请稍后使用原参数重试 |

请求示例

- [curl 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781546-curl.md)
- [Java 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781546-java.md)
- [Go 示例](https://pay.weixin.qq.com/doc/v3/partner/4015781546-go.md)


应答示例

> 200 OK

查询已关联门店列表

```
{
  "total_count" : 23,
  "store_list" : [
    {
      "store_id" : "100000001"
    },
    {
      "store_id" : "100000002"
    },
    {
      "store_id" : "100000003"
    }
  ],
  "next_page_token" : "MTIzNDUK"
}

```
