创建品牌门店

更新时间:2025.03.28

创建品牌门店

接口说明

支持商户:【普通商户】

请求方式:【POST】/v3/merchant-store/stores

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

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

请求参数
折叠全部参数

Header HTTP头参数

Authorization  必填 string

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


Accept  必填 string

请设置为application/json


Content-Type  必填 string

请设置为application/json


body 包体参数

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[StoreRecipientInfoWithCompanyName]

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

属性

mchid  必填 string(16)

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


company_name  选填 string(256)

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

请求示例

POST

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/merchant-store/stores \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Content-Type: application/json" \
6  -d '{
7    "store_basics" : {
8      "store_reference_id" : "MDL001",
9      "brand_name" : "麦当劳",
10      "store_name" : "麦当劳",
11      "branch_name" : "海岸城店",
12      "brand_id" : 1001
13    },
14    "store_address" : {
15      "address_code" : "440305",
16      "address_detail" : "深南大道10000号腾讯大厦1楼",
17      "address_complements" : "地铁A口右侧100米",
18      "longitude" : "112.63484",
19      "latitude" : "37.75464"
20    },
21    "store_business" : {
22      "service_phone" : "0755-86013388",
23      "business_hours" : "周一至周五 09:00-20:00"
24    },
25    "store_recipient" : [
26      {
27        "mchid" : "1230000109",
28        "company_name" : "腾讯科技(深圳)有限公司"
29      }
30    ]
31  }'
32

应答参数

200 OK

store_id  必填 integer

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

应答示例

200 OK

1{
2  "store_id" : 20488000
3}
4

 

错误码

公共错误码

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

请根据错误提示正确传入参数

400

INVALID_REQUEST

HTTP 请求不符合微信支付 APIv3 接口规则

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

 

 

元宝AI
反馈
目录
置顶