查询品牌门店

更新时间：2025.08.04

根据品牌门店ID，查询品牌门店。

接口说明

支持商户：【品牌商户】

请求方式：【GET】/brand/store/brandstores/{store_id}

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

　　　　　【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点，指引点击查看

请求参数

Header HTTP头参数

Authorization 　必填　string

请参考签名认证生成认证信息

Accept 　必填　string

请设置为application/json

Wechatpay-Serial 　必填　string

【微信支付公钥ID】请传入brand_id对应的微信支付公钥ID，接口将会校验两者的关联关系，参考微信支付公钥产品简介及使用说明获取微信支付公钥ID和相关的介绍。以下两种场景将使用到微信支付公钥： 1、接收到接口的返回内容，需要使用微信支付公钥进行验签； 2、调用含有敏感信息参数（如姓名、身份证号码）的接口时，需要使用微信支付公钥加密敏感信息后再传输参数，加密指引请参考微信支付公钥加密敏感信息指引。

path 路径参数

store_id 　必填 string

【品牌门店ID】创建品牌门店后，系统为该门店分配的唯一ID。

请求示例

GET

1curl -X GET \
2  https://api.mch.weixin.qq.com/brand/store/brandstores/1234567890123456 \
3  -H "Authorization: WECHATPAY-BRAND-SHA256-RSA2048 brand_id=\"XXXX\",..." \
4  -H "Accept: application/json" \
5  -H "Wechatpay-Serial: PUB_KEY_ID_XXXX"  
6

应答参数

200 OK

store_id 　选填 string

【品牌门店ID】创建品牌门店后，系统为该门店分配的唯一ID。

store_state 　选填 string

【门店状态】用于描述门店当前状态

可选取值

OPEN: 门店营业中。
CREATING: 门店创建中。在创建门店后，门店资料正在审核。审核详情请查看审核状态。
CLOSED: 门店已停业。不可用于微信支付生态中的其他业务，可删除该门店，删除后将无法恢复，请谨慎操作。

audit_state 　选填 string

【审核状态】创建、修改门店时，通过此字段可得知当前审核状态

可选取值

SUCCESS: 门店资料审核通过
PROCESSING: 门店资料审核中
REJECTED: 门店资料被驳回，请根据驳回原因进行修改。

review_reject_reason 　选填 string

【审核失败原因】门店资料审核失败的原因

store_basics 　选填 object

【门店基础信息】用于描述门店编码，名称等基本情况。

属性

store_address 　选填 object

【门店地址信息】用于描述门店地址，经纬度等地理位置相关情况。

属性

store_business 　选填 object

【门店经营信息】用于描述门店联系电话，经营时间等经营状况。

属性

store_recipient 　选填 array[object]

【门店收款信息】门店收款商户列表。

属性

mchid 　选填 string(16)

【门店收款商户号】门店的收款商户号，仅支持绑定品牌已关联的商户号。

company_name 　选填 string(256)

【门店收款主体】门店收款的主体信息，支持企业，个体户，小微。

recipient_state 　选填 string

【收款绑定状态】门店收款商户号的绑定状态

可选取值

CONFIRMED: 门店已绑定此收款商户号
ADMIN_REJECTED: 商户管理员已拒绝
CONFIRMING: 商户号管理员确认中
TIMEOUT_REJECTED: 由于商户管理员确认超时，系统自动拒绝此绑定

应答示例

200 OK

1{
2  "store_id" : "1234567890123456",
3  "store_state" : "OPEN",
4  "audit_state" : "SUCCESS",
5  "review_reject_reason" : "通过核实，您提交的电话错误，请核实手机号码或座机号码是否正确",
6  "store_basics" : {
7    "store_reference_id" : "MDL001",
8    "branch_name" : "海岸城店"
9  },
10  "store_address" : {
11    "address_code" : "440305",
12    "address_detail" : "深南大道10000号腾讯大厦1楼",
13    "address_complements" : "地铁A口右侧100米",
14    "longitude" : "112.63484",
15    "latitude" : "37.75464"
16  },
17  "store_business" : {
18    "service_phone" : "0755-86013388",
19    "business_hours" : "周一至周五 09:00-20:00"
20  },
21  "store_recipient" : [
22    {
23      "mchid" : "1230000109",
24      "company_name" : "腾讯科技（深圳）有限公司",
25      "recipient_state" : "CONFIRMED"
26    }
27  ]
28}
29

错误码

公共错误码

状态码	错误码	描述	解决方案
400	PARAM_ERROR	参数错误	请根据错误提示正确传入参数
400	INVALID_REQUEST	HTTP 请求不符合微信支付 APIv3 接口规则	请参阅接口规则
401	SIGN_ERROR	验证不通过	请参阅签名常见问题
500	SYSTEM_ERROR	系统异常，请稍后重试	请稍后重试

文档是否有帮助

更多支持

开发者社区微信开放平台微信公众平台腾讯客服