为商户提供合作关系列表的查询能力。

接口说明

支持商户：

【普通商户】

请求方式：

【GET】/v3/marketing/partnerships

请求域名：

【主域名】

https://api.mch.weixin.qq.com

使用该域名将访问就近的接入点

【备域名】

https://api2.mch.weixin.qq.com

使用该域名将访问异地的接入点 ，指引点击查看

请求参数

Header HTTP头参数
Authorization 必填 string
请参考 签名认证 生成认证信息
Accept 必填 string
请设置为 application/json

Query 查询参数
limit 选填 integer
【分页大小】 分页大小，最大50。 不传默认为20
offset 选填 integer
【分页页码】 分页页码，页码从0开始
partner 选填 PartnerInfo
【合作方信息】 合作方信息
• 属性
authorized_data 必填 AuthorizedDataFilter
【被授权数据】 被授权数据
• 属性

请求示例

GET

应答参数

200OK
data 选填 array[PartnershipsEntity]
【合作关系结果集】 合作关系查询结果集。如查询结果为0，将在控制流返回错误
• 属性
offset 必填 integer
【分页页码】 分页页码
limit 必填 integer
【分页大小】 分页大小
total_count 选填 integer
【总数量】 总数量，当offset=0或者当前查询为空时返回

应答示例

200 OK

错误码

公共错误码

状态码	错误码	描述	解决方案
400	PARAM_ERROR	参数错误	请根据错误提示正确传入参数
400	INVALID_REQUEST	HTTP 请求不符合微信支付 APIv3 接口规则	请参阅 接口规则
401	SIGN_ERROR	验证不通过	请参阅 签名常见问题
500	SYSTEM_ERROR	系统异常，请稍后重试	请稍后重试

业务错误码

状态码	错误码	描述	解决方案
400	APPID_MCHID_NOT_MATCH	appid与mchid不匹配	请确认appid是否正确填写
400	INVALID_REQUEST	请求参数符合参数格式，但不符合业务规则	根据错误提示，传入符合业务规则的参数
400	INVALID_REQUEST	委托营销合作关系不存在	请确认合作方信息是否正确
400	MCH_NOT_EXISTS	商户号不存在	请确认发券商户号信息是否有误
403	NO_AUTH	商户未被授权	登录商户平台核对，传入正确信息
404	RESOURCE_NOT_EXISTS	资源不存在或无可用	请确认资源均存在且可用
429	FREQUENCY_LIMITED	频率超限	请求量不要超过接口调用频率限制