---
url: "https://pay.weixin.qq.com/doc/v3/merchant/4012380498.md"
title: "建立合作关系"
doc_id: 4012380498
---

>更新时间：2024.08.26

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




## 接口说明

支持商户：【普通商户】

请求方式：【POST】 `/v3/marketing/partnerships/build`

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

　　　　　【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点，指引[点击查看](https://pay.weixin.qq.com/doc/v3/merchant/4012075113.md)

## 请求参数

### Header 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| Authorization | string | true | 请参考 [签名认证](https://pay.weixin.qq.com/doc/v3/merchant/4012365342.md#%E8%AF%B7%E6%B1%82%E6%8E%A5%E5%8F%A3%E5%90%8E%E7%AB%AF%E7%AD%BE%E5%90%8D) 生成认证信息 |
| Accept | string | true | 请设置为 `application/json` |
| Content-Type | string | true | 请设置为 `application/json` |
| Idempotency-Key | string | true | 【业务请求幂等值】商户侧需保持唯一性，可包含英文字母，数字，｜，\_，\*，-等内容，不允许出现其他不合法符号 |
### Body 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| partner | object | true | 【合作方信息】合作方信息 |
| partner.type | string | true | 【合作方类别】合作方类别，枚举值见文档<br>可选取值：<br><ul><li>`APPID`: 合作方为Appid</li></ul><br><ul><li>`MERCHANT`: 合作方为商户</li></ul> |
| partner.appid | string(32) | false | 【合作方Appid】合作方Appid,合作方类别为APPID时必填 |
| partner.merchant_id | string(15) | false | 【合作方商户ID】合作方商户ID，合作方类别为MERCHANT时必填 |
| authorized_data | object | true | 【被授权数据】被授权数据 |
| authorized_data.business_type | string | true | 【授权业务类别】授权业务类别，枚举值见文档<br>可选取值：<br><ul><li>`FAVOR_STOCK`: 授权业务类型-代金券批次</li></ul><br><ul><li>`BUSIFAVOR_STOCK`: 授权业务类型-商家券批次</li></ul> |
| authorized_data.stock_id | string(20) | false | 【授权批次ID】授权批次ID，授权业务类别为券批次时必填 |
## 应答参数

200 OK

| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| partner | object | true | 【合作方信息】合作方信息 |
| partner.type | string | true | 【合作方类别】合作方类别，枚举值见文档<br>可选取值：<br><ul><li>`APPID`: 合作方为Appid</li></ul><br><ul><li>`MERCHANT`: 合作方为商户</li></ul> |
| partner.appid | string(32) | false | 【合作方Appid】合作方Appid,合作方类别为APPID时必填 |
| partner.merchant_id | string(15) | false | 【合作方商户ID】合作方商户ID，合作方类别为MERCHANT时必填 |
| authorized_data | object | true | 【被授权数据】被授权数据 |
| authorized_data.business_type | string | true | 【授权业务类别】授权业务类别，枚举值见文档<br>可选取值：<br><ul><li>`FAVOR_STOCK`: 授权业务类型-代金券批次</li></ul><br><ul><li>`BUSIFAVOR_STOCK`: 授权业务类型-商家券批次</li></ul> |
| authorized_data.stock_id | string(20) | false | 【授权批次ID】授权批次ID，授权业务类别为券批次时必填 |
| state | string | true | 【合作状态】合作状态，枚举值见文档<br>可选取值：<br><ul><li>`ESTABLISHED`: 合作状态-已建立</li></ul><br><ul><li>`TERMINATED`: 合作状态-已终止</li></ul> |
| build_time | string(32) | true | 【建立合作关系时间】建立合作关系时间，遵循 [rfc3339](https://datatracker.ietf.org/doc/html/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秒。 |
| create_time | string(32) | true | 【创建时间】创建时间，遵循 [rfc3339](https://datatracker.ietf.org/doc/html/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秒。 |
| update_time | string(32) | true | 【更新时间】更新时间，遵循 [rfc3339](https://datatracker.ietf.org/doc/html/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秒。 |
## 错误码

### 公共错误码

| 状态码 | 错误码 | 描述 | 解决方案 |
| --- | --- | --- | --- |
| 400 | PARAM\_ERROR | 参数错误 | 请根据错误提示正确传入参数 |
| 400 | INVALID\_REQUEST | HTTP 请求不符合微信支付 APIv3 接口规则 | 请参阅 [接口规则](https://pay.weixin.qq.com/doc/v3/merchant/4012081709.md) |
| 401 | SIGN\_ERROR | 验证不通过 | 请参阅 [签名常见问题](https://pay.weixin.qq.com/doc/v3/merchant/4012072670.md) |
| 500 | SYSTEM\_ERROR | 系统异常，请稍后重试 | 请稍后重试 |

### 业务错误码

| 状态码 | 错误码 | 描述 | 解决方案 |
| --- | --- | --- | --- |
| 400 | APPID\_MCHID\_NOT\_MATCH | appid与mchid不匹配 | 请确认appid是否正确填写 |
| 400 | INVALID\_REQUEST | 请求参数符合参数格式，但不符合业务规则 | 根据错误提示，传入符合业务规则的参数 |
| 400 | MCH\_NOT\_EXISTS | 商户号不存在 | 请确认发券商户号信息是否有误 |
| 401 | SIGN\_ERROR | 签名错误或签名信息不完整 | 登录商户平台核对，传入正确信息 |
| 403 | NO\_AUTH | 商户未被授权 | 登录商户平台核对，传入正确信息 |
| 404 | RESOURCE\_NOT\_EXISTS | 资源不存在或无可用 | 请确认资源均存在且可用 |
| 429 | FREQUENCY\_LIMITED | 频率超限 | 请求量不要超过接口调用频率限制 |

请求示例

- [curl 示例](https://pay.weixin.qq.com/doc/v3/merchant/4012380498-curl.md)
- [Java 示例](https://pay.weixin.qq.com/doc/v3/merchant/4012380498-java.md)
- [Go 示例](https://pay.weixin.qq.com/doc/v3/merchant/4012380498-go.md)


应答示例

> 200 OK

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

```
