查询品牌门店

更新时间：2025.03.28

查询品牌门店

接口说明

支持商户：【普通商户】

请求方式：【GET】/v3/merchant-store/stores/{store_id}

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

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

请求参数

Header HTTP头参数

Authorization 　必填　string

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

Accept 　必填　string

请设置为application/json

path 路径参数

store_id 　必填 integer

【微信支付商户门店ID】微信支付分配全局唯一的门店ID。

请求示例

GET

1curl -X GET \
2  https://api.mch.weixin.qq.com/v3/merchant-store/stores/20488000 \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" 
5

应答参数

200 OK

store_basics 　选填 object

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

属性

store_address 　选填 object

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

属性

store_business 　选填 object

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

属性

store_recipient 　选填 array[object]

【门店收款信息】用于描述门店收款信息，添加后需要收款账号管理员确认门店信息，目前只支持录入一则收款信息。

属性

store_state 　选填 object

【门店状态】用于描述门店状态及其详情信息。

属性

store_state_value 　选填 string

【门店状态值】门店状态枚举值

可选取值

STORE_STATE_VALID: 门店创建成功，门店方已确认收款信息，地址核实成功，可用于微信支付生态中其他业务。
STORE_STATE_ADDRESS_VERIFYING: 门店创建成功，门店方已确认收款信息，地址处于核实状态，暂不支持基于地理位置的流量应用，请等待核实结果。
STORE_STATE_ADDRESS_FAILED: 门店创建成功，门店方已确认收款信息，地址核实失败，不支持基于地理位置的流量应用，请根据驳回原因修改地址信息。
STORE_STATE_RECIPIENT_REFUSED: 门店收款商户号超级管理员已拒绝，或超过10天未确认该门店的收款关系，门店创建失败。
STORE_STATE_CLOSED: 门店处于停业状态，不可用于微信支付生态中的其他业务，支持登录商户平台删除该门店，删除后将无法恢复，请谨慎操作。
STORE_STATE_RECIPIENT_VERIFYING: 待门店收款商户确认，请联系收款商户号的超级管理员打开微信下发的“收款关系确认消息”，并根据页面指引完成确认流程。

store_state_message 　选填 string

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

address_failed_reason 　选填 string

【地址核实失败原因】地址核实失败原因

应答示例

200 OK

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

错误码

公共错误码

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

文档是否有帮助

更多支持

开发文档(服务商)开发文档(V2版)开发者社区微信开放平台微信公众平台腾讯客服