终止合作关系

更新时间：2026.01.13

该接口主要为商户提供营销资源的终止授权能力，便于商户管理运营现存的合作关系。

接口说明

适用对象：服务商

请求URL：https://api.mch.weixin.qq.com/v3/marketing/partnerships/terminate

请求方式：POST

path 指该参数为路径参数

query 指该参数需在请求URL传参

body 指该参数需在请求JSON传参

请求包头

参数名	变量	类型[长度限制]	必填	描述
业务请求幂等值	Idempotency-Key	string[1,48]	是	请求包头业务请求幂等值通过 HTTP头部 Idempotency-Key：传递。业务请求幂等值，商户侧需保持唯一性，可包含英文字母，数字，｜，_，*，-等内容，不允许出现其他不合法符号示例值：12345

请求参数

参数名

变量

类型[长度限制]

必填

描述

合作方信息

partner

object

是

body 合作方相关的信息。

属性

被授权数据

authorized_data

object

是

body 被授权的数据。

属性

请求示例

1// 请求头
2POST/https://api.mch.weixin.qq.com/v3/marketing/partnerships/terminate
3Idempotency-Key:12345
4
5// 请求json
6{
7  "authorized_data" : {
8    "business_type" : "FAVOR_STOCK",
9    "stock_id" : "2433405"
10  },
11  "partner" : {
12    "appid" : "wx4e1916a585d1f4e9",
13    "type" : "APPID"
14  }
15}

返回参数

参数名	变量	类型[长度限制]	必填	描述
终止合作关系时间	terminate_time	string[1,32]	是	终止合作关系时间，遵循rfc3339标准格式，格式为yyyy-MM-DDTHH:mm:ss.sss+TIMEZONE，yyyy-MM-DD表示年月日， T出现在字符串中，表示time元素的开头，HH:mm:ss.sss表示时分秒毫秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35.120+08:00表示，北京时间2015年5月20日13点29分35秒。示例值：2015-05-20T13:29:35.120+08:00

参数名

变量

类型[长度限制]

必填

描述

终止合作关系时间

terminate_time

string[1,32]

是

终止合作关系时间，遵循rfc3339标准格式，格式为yyyy-MM-DDTHH:mm:ss.sss+TIMEZONE，yyyy-MM-DD表示年月日，

T出现在字符串中，表示time元素的开头，HH:mm:ss.sss表示时分秒毫秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。

例如：2015-05-20T13:29:35.120+08:00表示，北京时间2015年5月20日13点29分35秒。
示例值：2015-05-20T13:29:35.120+08:00

返回示例

1{	
2  "terminate_time" : "2015-05-20T13:29:35.120+08:00"
3}

错误码

公共错误码

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

文档是否有帮助

LLM请查看llms.txt

开发文档(商户)开发文档(品牌)开发文档(V2版)开发文档(银行/机构)开发者社区微信开放平台微信公众平台腾讯客服