查询品牌门店

更新时间: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。


query 查询参数

sub_mchid  选填 string(16)

【特约商户号】 门店归属的特约商户,其在微信支付分配的特约商户号。
服务商调用时必填;品牌主商户号自行调用时非必填;
示例值: 1900000109

请求示例

GET

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

应答参数
折叠全部参数

200 OK

store_basics  选填 object

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

属性

store_reference_id  选填 string(32)

【商家门店编号】 商家内部的门店编号,最长32位字符;商家自行保证该编码在商家内部的唯一性。不允许有符号表情。


brand_name  必填 string(32)

【品牌名称】 商家所拥有的品牌,该品牌需要已完成微信支付认证;未填写则默认为"其他品牌"。


store_name  必填 string(32)

【门店名称】 商家的门店名称,一般与商家门头照一致,不要包含分店信息;如果填了品牌名称,则门店名称必须和品牌名称一致;门店名称长度不超过32位字符。


branch_name  选填 string(20)

【分店名称】 分店名称,比如:"南山店",不需要“(” “)”等辅助标记,与门店名称合并后对外展示“麦当劳(南山店)”,分店名称长度不超过32位字符。


brand_id  选填 integer

【品牌ID】 微信支付分配用来标识品牌的全局唯一ID。


store_address  选填 object

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

属性

address_code  必填 string(20)

【门店省市编码】 门店所在省市区编码,只能由数字组成;详细参见微信支付提供的省市对照表


address_detail  必填 string(100)

【门店地址】 门店地址为核心重要信息,请准确填写并精确到门牌号,该信息涉及到地址核实、营销活动等业务,说明:不要重复填写省市区信息,地址长度在4-64位字符。


address_complements  选填 string(50)

【门店地址辅助描述】 门店周围标志性建筑,用于辅助定位。


longitude  选填 string(32)

【门店经度】 经度,取值在[-180,180]之间的数字,经度长度不能超过32个字符,腾讯地图经纬度查询:https://lbs.qq.com/tool/getpoint/index.html


latitude  选填 string(32)

【门店纬度】 纬度,取值在[-90,90]之间的数字,纬度长度不能超过32个字符,腾讯地图经纬度查询:https://lbs.qq.com/tool/getpoint/index.html


store_business  选填 object

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

属性

service_phone  选填 string(32)

【门店服务电话】 支持座机和手机,只支持数字和“-”符号,最多支持两个电话,两个电话间用分号“|”区隔。


business_hours  选填 string(256)

【门店经营时间】 请严格按"周一至周五 09:00-20:00|周六至周日 10:00-22:00"的格式进行填写,时间段不能重复,最多支持两个时间段,两个时间段间用英文分号“|”区隔


store_recipient  选填 array[object]

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

属性

mchid  必填 string(16)

【门店收款商户号】 门店收款商户号,填入品牌主主体一致的商户号,或门店收款主体所拥有的商户号。


company_name  选填 string(256)

【门店收款主体】 门店收款的主体信息,支持企业,个体户,小微;若收款商户号为当前服务商的特约商户,则该信息可免填。


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

系统异常,请稍后重试

请稍后重试

 

 

元宝AI
反馈
目录
置顶