商户进件
特约商户进件
基础支付
JSAPI支付
APP支付
H5支付
Native支付
小程序支付
合单支付
付款码支付
经营能力
支付即服务
点金计划
行业方案
电商收付通(商户进件)
电商收付通(普通支付)
电商收付通(合单支付)
电商收付通(分账)
电商收付通(补差)
电商收付通(退款)
电商收付通(余额查询)
电商收付通(商户提现)
电商收付通(下载账单)
智慧商圈
微信支付分停车服务
营销工具
代金券
商家券
委托营销
支付有礼
小程序发券插件
H5发券
图片上传(营销专用)
现金红包
资金应用
分账
连锁品牌分账
风险合规
商户开户意愿确认
消费者投诉2.0
其他能力
图片上传
视频上传

建立合作关系API

最新更新时间:2020.04.09 版本说明


该接口主要为商户提供营销资源的授权能力,可授权给其他商户或小程序,方便商户间的互利合作。

接口说明

适用对象:服务商

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

请求方式:POST


path指该参数为路径参数

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

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


请求包头

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

请求参数

参数名 变量 类型[长度限制] 必填 描述
+合作方信息 partner object body 合作方相关的信息。
参数名 变量 类型[长度限制] 必填 描述
合作方类别 type string[1,32] 合作方类别,枚举值:
APPID:合作方为APPID
MERCHANT:合作方为商户
示例值:APPID
合作方APPID appid string[1,32] 合作方APPID,合作方类别为APPID时必填。
示例值:wx4e1916a585d1f4e9
合作方商户ID merchant_id string[8,15] 合作方商户ID,合作方类别为MERCHANT时必填。
示例值:2480029552
+被授权数据 authorized_data object body 被授权的数据。
参数名 变量 类型[长度限制] 必填 描述
授权业务类别 business_type string[1,32] 授权业务类别,枚举值:
FAVOR_STOCK:代金券批次
BUSIFAVOR_STOCK:商家券批次
示例值:FAVOR_STOCK
授权批次ID stock_id string[1,20] 授权批次ID,授权业务类别为商家券批次或代金券批次时,此参数必填。
示例值:2433405

请求示例


// 请求头
Idempotency-Key:12345

// 请求json
{
  "authorized_data" : {
    "business_type" : "FAVOR_STOCK",
    "stock_id" : "2433405"
  },
  "partner" : {
    "appid" : "wx4e1916a585d1f4e9",
    "type" : "APPID"
  }
}
    
{
JAVA示例代码
}
    

返回参数

参数名 变量 类型[长度限制] 必填 描述
+合作方信息 partner object 合作方相关的信息。
参数名 变量 类型[长度限制] 必填 描述
合作方类别 type string[1,32] 合作方类别,枚举值:
APPID:合作方为APPID
MERCHANT:合作方为商户
示例值:APPID
合作方APPID appid string[1,32] 合作方APPID,合作方类别为APPID时必填。
示例值:wx4e1916a585d1f4e9
合作方商户ID merchant_id string[8,15] 合作方商户ID,合作方类别为MERCHANT时必填。
示例值:2480029552
+被授权数据 authorized_data object 被授权的数据。
参数名 变量 类型[长度限制] 必填 描述
授权业务类别 business_type string[1,32] 授权业务类别,枚举值:
FAVOR_STOCK:代金券批次
BUSIFAVOR_STOCK:商家券批次
示例值:FAVOR_STOCK
授权场景 scenarios array 授权场景,不填默认所有场景。(该字段暂未开放)
枚举值:
COUPON_SEND:发券场景
STOCK_QUERY :查批次信息场景
示例值:COUPON_SEND
授权批次ID stock_id string[1,20] 授权批次ID,授权业务类别为商家券批次或代金券批次时,此参数必填。
示例值:2433405
合作状态 state string[1,32] 合作状态,枚举值:
ESTABLISHED:已建立
TERMINATED:已终止
示例值:ESTABLISHED
建立合作关系时间 build_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
创建时间 create_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
更新时间 update_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

返回示例


{	
 "authorized_data" : {
      "business_type" : "FAVOR_STOCK",
      "scenarios":[""],
      "stock_id" : "2433405"
    },
   "update_time" : "2015-05-20T13:29:35.120+08:00",
   "partner" : {
        "appid" : "wx4e1916a585d1f4e9",
        "type" : "APPID"
    },
   "create_time" : "2015-05-20T13:29:35.120+08:00",
   "build_time" : "2015-05-20T13:29:35.120+08:00",
   "state" : "ESTABLISHED"
}
                                

    http://2323weixin.qq.com
                                

错误码公共错误码

状态码 错误码 描述 解决方案
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 签名错误或签名信息不完整 登录商户平台核对,传入正确信息


技术咨询

文档反馈