创建品牌门店
更新时间: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 包体参数
sub_mchid 选填 string(16)
【特约商户号】 门店归属的特约商户,其在微信支付分配的特约商户号。服务商调用时必填;品牌主商户号自行调用时非必填。
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
应答参数
200 OK
store_id 必填 integer
【微信支付商户门店ID】 微信支付分配全局唯一的门店ID。
应答示例
200 OK
错误码
公共错误码
状态码 | 错误码 | 描述 | 解决方案 |
|---|---|---|---|
400 | PARAM_ERROR | 参数错误 | 请根据错误提示正确传入参数 |
400 | INVALID_REQUEST | HTTP 请求不符合微信支付 APIv3 接口规则 | 请参阅 接口规则 |
401 | SIGN_ERROR | 验证不通过 | 请参阅 签名常见问题 |
500 | SYSTEM_ERROR | 系统异常,请稍后重试 | 请稍后重试 |

