---
url: "https://pay.weixin.qq.com/doc/brand/4015783036.md"
title: "更新品牌门店"
doc_id: 4015783036
---

>更新时间：2025.08.04

根据品牌门店ID，更新门店资料。




## 接口说明

支持商户：【品牌商户】

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

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

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

接口限频：900/分钟（品牌ID维度）

## 请求参数

### Header 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| Authorization | string | true | 请参考 [签名认证](https://pay.weixin.qq.com/doc/brand/4015407568.md) 生成认证信息 |
| Accept | string | true | 请设置为 `application/json` |
| Content-Type | string | true | 请设置为 `application/json` |
| Wechatpay-Serial | string | true | 【微信支付公钥ID】  请传入brand\_id对应的微信支付公钥ID，接口将会校验两者的关联关系，参考 [微信支付公钥产品简介及使用说明](https://pay.weixin.qq.com/doc/brand/4015597001.md) 获取微信支付公钥ID和相关的介绍。以下两种场景将使用到微信支付公钥：<br>1、接收到接口的返回内容，需要使用微信支付公钥进行验签；<br>2、调用含有敏感信息参数（如姓名、身份证号码）的接口时，需要使用微信支付公钥加密敏感信息后再传输参数，加密指引请参考 [微信支付公钥加密敏感信息指引](https://pay.weixin.qq.com/doc/brand/4015407587.md)。 |
### Path 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| store_id | string | true | 【品牌门店ID】 创建品牌门店后，系统为该门店分配的唯一ID。 |
### Body 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| store_basics | object | false | 【门店基础信息】 用于描述门店编码，名称等基本情况。 |
| store_basics.store_reference_id | string(32) | false | 【商家门店编号】 商家内部的门店编号，最长32位字符；商家自行保证该编码在商家内部的唯一性。不允许有符号表情。<br>此字段为免审字段（仅修改免审字段时，将会直接更新门店，无需审核）。 |
| store_basics.branch_name | string(50) | false | 【门店名称】 只需填写纯粹的分店名称，例如："南山店"、"朝阳门店"、"天河城店"<br><ul><li>不要包含任何括号、破折号等辅助符号</li><li>系统会自动将该名称与品牌名组合展示，最终呈现格式为："品牌名(分店名)"，例如："麦当劳(南山店)"。</li></ul> |
| store_address | object | false | 【门店地址信息】 用于描述门店地址，经纬度等地理位置相关情况。 |
| store_address.address_code | string(20) | true | 【门店省市编码】 门店所在省市区编码，只能由数字组成；详细参见 [微信支付提供的省市对照表](https://pay.weixin.qq.com/doc/v3/partner/4012082815.md)。 |
| store_address.address_detail | string(200) | true | 【门店地址】 门店地址为核心重要信息，请准确填写并精确到门牌号，该信息涉及到地址核实、营销活动等业务，说明：不要重复填写省市区信息。 |
| store_address.address_complements | string(50) | false | 【门店地址辅助描述】 门店周围标志性建筑，用于辅助定位。 |
| store_address.longitude | string(32) | false | 【门店经度】 经度，取值在\[-180,180\]之间的数字，经度长度不能超过32个字符，腾讯地图经纬度查询： [https://lbs.qq.com/tool/getpoint/index.html](https://lbs.qq.com/tool/getpoint/index.html) |
| store_address.latitude | string(32) | false | 【门店纬度】 纬度，取值在\[-90,90\]之间的数字，纬度长度不能超过32个字符，腾讯地图经纬度查询： [https://lbs.qq.com/tool/getpoint/index.html](https://lbs.qq.com/tool/getpoint/index.html) |
| store_business | object | false | 【门店经营信息】 用于描述门店联系电话，经营时间等经营状况。 |
| store_business.service_phone | string(32) | false | 【门店服务电话】 支持座机和手机，只支持数字和“-”符号，最多支持两个电话，两个电话间用英文竖线“&#124;”区隔。<br>此字段为免审字段（仅修改免审字段时，将会直接更新门店，无需审核）。 |
| store_business.business_hours | string(256) | false | 【门店经营时间】 经营时间需要使用指定格式，如下：<br><ul><li>最多支持 7 个时间段，时间段间用英文竖线"｜"分隔，严格按 “周一至周五 09:00-20:00&#124;周六至周日 10:00-22:00” 的格式进行填写；</li><li>支持填写跨日经营时间，需在终止时间前添加“次日”，严格参照“周一至周五 09:00-次日2:00” 格式填写，跨日周期不得超过 24 小时；</li><li>此字段为免审字段（仅修改免审字段时，将会直接更新门店，无需审核）。</li></ul> |
## 应答参数

200 OK

| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| store_id | string | false | 【品牌门店ID】 创建品牌门店后，系统为该门店分配的唯一ID。 |
| store_state | string | false | 【门店状态】 用于描述门店当前状态<br>可选取值<br><ul><li>`OPEN`:  门店生效中。门店审核通过创建成功后即为生效中，后续更新门店信息只会影响审核状态，不会改变门店状态，如门店暂停营业可调用“暂停门店营业 API”，如门店关闭可调用“删除品牌门店 API”。门店营业时间不影响门店状态。</li><li>`CREATING`:  门店创建中。在创建门店后，门店资料正在审核。审核详情请查看审核状态。</li><li>`CLOSED`:  门店停业中。不可用于微信支付生态中的其他业务，可删除该门店，删除后将无法恢复，请谨慎操作。</li></ul> |
| audit_state | string | false | 【审核状态】 创建、修改门店时，通过此字段可得知当前审核状态<br>可选取值<br><ul><li>`SUCCESS`:  门店资料审核通过。</li><li>`PROCESSING`:  门店资料审核中，请等待审核结果。</li><li>`REJECTED`:  门店资料被驳回，请根据驳回原因进行修改。</li></ul> |
| review_reject_reason | string | false | 【审核失败原因】 门店资料审核失败的原因 |
| store_basics | object | false | 【门店基础信息】 用于描述门店编码，名称等基本情况。 |
| store_basics.store_reference_id | string(32) | false | 【商家门店编号】 商家内部的门店编号，最长32位字符；商家自行保证该编码在商家内部的唯一性。不允许有符号表情。<br>此字段为免审字段（仅修改免审字段时，将会直接更新门店，无需审核）。 |
| store_basics.branch_name | string(50) | false | 【门店名称】 只需填写纯粹的分店名称，例如："南山店"、"朝阳门店"、"天河城店"<br><ul><li>不要包含任何括号、破折号等辅助符号</li><li>系统会自动将该名称与品牌名组合展示，最终呈现格式为："品牌名(分店名)"，例如："麦当劳(南山店)"。</li></ul> |
| store_address | object | false | 【门店地址信息】 用于描述门店地址，经纬度等地理位置相关情况。 |
| store_address.address_code | string(20) | true | 【门店省市编码】 门店所在省市区编码，只能由数字组成；详细参见 [微信支付提供的省市对照表](https://pay.weixin.qq.com/doc/v3/partner/4012082815.md)。 |
| store_address.address_detail | string(200) | true | 【门店地址】 门店地址为核心重要信息，请准确填写并精确到门牌号，该信息涉及到地址核实、营销活动等业务，说明：不要重复填写省市区信息。 |
| store_address.address_complements | string(50) | false | 【门店地址辅助描述】 门店周围标志性建筑，用于辅助定位。 |
| store_address.longitude | string(32) | false | 【门店经度】 经度，取值在\[-180,180\]之间的数字，经度长度不能超过32个字符，腾讯地图经纬度查询： [https://lbs.qq.com/tool/getpoint/index.html](https://lbs.qq.com/tool/getpoint/index.html) |
| store_address.latitude | string(32) | false | 【门店纬度】 纬度，取值在\[-90,90\]之间的数字，纬度长度不能超过32个字符，腾讯地图经纬度查询： [https://lbs.qq.com/tool/getpoint/index.html](https://lbs.qq.com/tool/getpoint/index.html) |
| store_business | object | false | 【门店经营信息】 用于描述门店联系电话，经营时间等经营状况。 |
| store_business.service_phone | string(32) | false | 【门店服务电话】 支持座机和手机，只支持数字和“-”符号，最多支持两个电话，两个电话间用英文竖线“&#124;”区隔。<br>此字段为免审字段（仅修改免审字段时，将会直接更新门店，无需审核）。 |
| store_business.business_hours | string(256) | false | 【门店经营时间】 经营时间需要使用指定格式，如下：<br><ul><li>最多支持 7 个时间段，时间段间用英文竖线"｜"分隔，严格按 “周一至周五 09:00-20:00&#124;周六至周日 10:00-22:00” 的格式进行填写；</li><li>支持填写跨日经营时间，需在终止时间前添加“次日”，严格参照“周一至周五 09:00-次日2:00” 格式填写，跨日周期不得超过 24 小时；</li><li>此字段为免审字段（仅修改免审字段时，将会直接更新门店，无需审核）。</li></ul> |
| store_recipient | array[object] | false | 【门店收款信息】 门店收款商户列表。 |
| store_recipient.mchid | string(16) | false | 【门店收款商户号】 门店的收款商户号，仅支持绑定品牌已关联的商户号。 |
| store_recipient.company_name | string(256) | false | 【门店收款主体】 门店收款的主体信息，支持企业，个体户，小微。 |
| store_recipient.recipient_state | string | false | 【收款绑定状态】 门店收款商户号的绑定状态<br>可选取值<br><ul><li>`CONFIRMED`:  门店已绑定此收款商户号</li><li>`ADMIN_REJECTED`:  商户管理员已拒绝</li><li>`CONFIRMING`:  商户号管理员确认中</li><li>`TIMEOUT_REJECTED`:  由于商户管理员确认超时，系统自动拒绝此绑定</li></ul> |
## 错误码

以下是本接口返回的错误码列表。详细错误码规则，请参考[微信支付接口规则-错误码和错误提示](https://pay.weixin.qq.com/doc/brand/4015407525.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/brand/4015407525.md) |
| 401 | SIGN\_ERROR | 验证不通过 | 请参阅 [签名常见问题](https://pay.weixin.qq.com/doc/brand/4015597625.md) |
| 500 | SYSTEM\_ERROR | 系统异常，请稍后重试 | 请稍后重试 |
| 400 | PARAM\_ERROR | 商家门店编码不合法 | 请参考文档中对每个字段的要求以及组合要求，确认请求参数是否满足 |
| 400 | INVALID\_REQUEST | 门店地址信息不准确或不存在 | 请参考文档中对地址字段的要求，进一步补充地址信息（如精确至xx路xx号） |
| 400 | PARAM\_ERROR | 经营时间不合法，跨日经营的时间跨度不得超过 24小时 | 请参考文档中对每个字段的要求以及组合要求，确认请求参数是否满足 |
| 400 | PARAM\_ERROR | 经营时间不合法，最多支持设置 7 个时间段 | 请参考文档中对每个字段的要求以及组合要求，确认请求参数是否满足 |
| 400 | PARAM\_ERROR | 门店经度不合法 | 请参考文档中对每个字段的要求以及组合要求，确认请求参数是否满足 |
| 400 | PARAM\_ERROR | 经营时间不合法 | 请参考文档中对每个字段的要求以及组合要求，确认请求参数是否满足 |
| 400 | PARAM\_ERROR | 门店纬度不合法 | 请参考文档中对每个字段的要求以及组合要求，确认请求参数是否满足 |
| 400 | PARAM\_ERROR | 分店名称不合法 | 请参考文档中对每个字段的要求以及组合要求，确认请求参数是否满足 |
| 400 | PARAM\_ERROR | 门店地址编码不合法 | 请参考文档中对每个字段的要求以及组合要求，确认请求参数是否满足 |
| 400 | PARAM\_ERROR | 服务电话不合法 | 请参考文档中对每个字段的要求以及组合要求，确认请求参数是否满足 |
| 400 | PARAM\_ERROR | 门店状态暂不支持修改 | 请参考文档中对每个字段的要求以及组合要求，确认请求参数是否满足 |
| 404 | NOT\_FOUND | 品牌门店不存在 | 请确认门店存在且属于该品牌 |
| 400 | ALREADY\_EXISTS | 品牌门店已存在 | 请检查上传的门店信息或使用已有的门店 |
| 400 | PARAM\_ERROR | 参数错误 | 请参考文档中对每个字段的要求以及组合要求，确认请求参数是否满足 |
| 429 | RATELIMIT\_EXCEEDED | 请求超过频率限制 | 请稍后使用原参数重试 |
| 500 | SYSTEM\_ERROR | 系统异常，请稍后重试 | 请稍后使用原参数重试 |
| 400 | PARAM\_ERROR | Http header中缺少必填参数Wechatpay-Serial | 缺少必要商品券图片，请补充上传后重试 |

请求示例

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


应答示例

> 200 OK

```
{
  "store_id" : "1234567890123456",
  "store_state" : "OPEN",
  "audit_state" : "SUCCESS",
  "review_reject_reason" : "通过核实，您提交的电话错误，请核实手机号码或座机号码是否正确",
  "store_basics" : {
    "store_reference_id" : "MDL001",
    "branch_name" : "海岸城店"
  },
  "store_address" : {
    "address_code" : "440305",
    "address_detail" : "深南大道10000号腾讯大厦1楼",
    "address_complements" : "地铁A口右侧100米",
    "longitude" : "112.63484",
    "latitude" : "37.75464"
  },
  "store_business" : {
    "service_phone" : "0755-86013388|0755-86013399",
    "business_hours" : "周一至周五 09:00-20:00|周六至周日 10:00-次日22:00"
  },
  "store_recipient" : [
    {
      "mchid" : "1230000109",
      "company_name" : "腾讯科技（深圳）有限公司",
      "recipient_state" : "CONFIRMED"
    }
  ]
}

```
