获得品牌已授权且在生效中的产品权限信息

更新时间:2026.01.29

获得品牌已授权且在生效中的产品权限信息

接口说明

支持商户:【普通服务商】

请求方式:【GET】/v3/brand-basic/partner/brands/{brand_id}/product-authorities

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

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

接口限频:10/秒(商户号维度)

请求参数

Header  HTTP头参数

 Authorization  必填 string

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


 Accept  必填 string

请设置为application/json


path  路径参数

 brand_id  必填   string

【品牌名称】 授权的品牌ID

请求示例

curl
Java
Go

GET

1curl -X GET \
2  https://api.mch.weixin.qq.com/v3/brand-basic/partner/brands/brand_id_example/product-authorities \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" 
5

应答参数

200 OK

 brand_id  必填   string

【品牌ID】 授权的品牌ID


 authorization_type  必填   string

【授权类型】 授权类型

可选取值

  • AUTHORIZATION_TYPE_HOSTING:  全托管模式

  • AUTHORIZATION_TYPE_PARTLY:  部分授权


 authorization_product  选填   array[string]

【授权产品权限】 品牌已授权产品权限

可选取值

  • BRAND_PRODUCT_AUTHORITY_MERCHANT_CARD:  商家名片产品权限

  • BRAND_PRODUCT_AUTHORITY_CARD_LINK:  交易连接名片产品权限

  • BRAND_PRODUCT_AUTHORITY_PRODUCT_COUPON:  商品券产品权限

  • BRAND_PRODUCT_AUTHORITY_SHAKE_COUPON:  摇优惠产品权限

  • BRAND_PRODUCT_AUTHORITY_BRAND_PAY_GIFT:  品牌支付有礼产品权限

  • BRAND_PRODUCT_AUTHORITY_BRAND_STORE:  品牌门店产品权限

  • BRAND_PRODUCT_AUTHORITY_PAYMENT_MERCHANT_MANAGE:  收款商户号管理产品权限

  • BRAND_PRODUCT_AUTHORITY_APPID_MANAGE:  下单AppID管理产品权限

  • BRAND_PRODUCT_AUTHORITY_FINDER_MANAGE:  视频号管理产品权限

  • BRAND_PRODUCT_AUTHORITY_CATEGORY_MANAGE:  品类管理产品


 update_time  必填   string

【更新时间】 产品权限更新时间,为微信支付记录的权限数据更新时间。格式:遵循rfc3339标准格式:yyyy-MM-DDTHH:mm:ss+TIMEZONEyyyy-MM-DD 表示年月日;T 字符用于分隔日期和时间部分;HH:mm:ss 表示具体的时分秒;TIMEZONE 表示时区(例如,+08:00 对应东八区时间,即北京时间)。示例:2025-05-20T13:29:35+08:00 表示北京时间2025年5月20日13点29分35秒。

应答示例

200 OK

1{
2  "brand_id" : "example_brand_id",
3  "authorization_type" : "AUTHORIZATION_TYPE_HOSTING",
4  "authorization_product" : [
5    "BRAND_PRODUCT_AUTHORITY_MERCHANT_CARD"
6  ],
7  "update_time" : "2025-05-20T13:29:35+08:00"
8}
9

 

错误码

以下是本接口返回的错误码列表。详细错误码规则,请参考微信支付接口规则-错误码和错误提示

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

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

400

INVALID_REQUEST

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

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

429

FREQUENCY_LIMITED

请求过快,达到接口频率限制

请降低请求频率 

400

INVALID_REQUEST

异常错误,请重试,如反复出现,可联系微信支付技术支持获取更多帮助

异常错误,请重试,如反复出现,可联系微信支付技术支持获取更多帮助

403

NO_AUTH

无操作权限,请开通品牌经营管理权限

请开通品牌经营管理权限

400

PARAM_ERROR

品牌ID错误,或未建立授权关系

请先与品牌建立授权关系

 

元宝AI
反馈
目录
置顶