适用对象： 服务商
请求URL： https://api.mch.weixin.qq.com/v3/marketing/busifavor/coupons/associate
请求方式： POST
接口频率： 500QPS
前置条件： 已为用户发券，且调用查询接口查到用户的券code、批次ID等信息
path 指该参数为路径参数
query 指该参数需在请求URL传参
body 指该参数需在请求JSON传参
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 批次号 | stock_id | string[1,20] | 是 | body 微信为每个商家券批次分配的唯一ID，对于商户自定义code的批次，关联请求必须填写批次号 示例值：100088 |
| 券code | coupon_code | string[1,32] | 是 | body 券的唯一标识 示例值：sxxe34343434 |
| 关联的商户订单号 | out_trade_no | string[1,128] | 是 | body 微信支付下单时的商户订单号，欲与该商家券关联的微信支付 示例值：MCH_102233445 |
| 商户请求单号 | out_request_no | string[1,128] | 是 | body 商户创建批次凭据号（格式：商户id+日期+流水号），商户侧需保持唯一性，可包含英文字母，数字，｜，_，*，-等内容，不允许出现其他不合法符号。 示例值：1002600620019090123143254435 |
{
"coupon_code" : "sxxe34343434",
"out_trade_no" : "MCH_102233445",
"stock_id" : "100088",
"out_request_no" : "1002600620019090123143254435"
}
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 关联成功时间 | wechatpay_associate_time | string[1,32] | 是 | 系统关联券成功的时间，遵循rfc3339标准格式，格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35+08:00表示，北京时间2015年5月20日 13点29分35秒。 示例值：2015-05-20T13:29:35+08:00 |
{
"wechatpay_associate_time" : "2015-05-20T13:29:35+08:00"
}
| 状态码 | 错误码 | 描述 | 解决方案 |
|---|---|---|---|
| 400 | PARAM_ERROR | 请求参数错误 | 请按照api文档检查并更换参数后重试 |
| 500 | SYSTEM_ERROR | 系统失败，请稍后重试 | 请用相同的请求包继续重试 |
| 400 | INVALID_REQUEST | 券不存在 | 券不存在，请核实批次号&券code后更换请求重试 |
| 400 | INVALID_REQUEST | 券状态非可用态 | 券状态非可用态，请核实批次号&券code后更换请求重试 |
| 400 | INVALID_REQUEST | 券已被其他单号关联 | 关联接口的报错返回，此类情况是券已关联了其他的单号，请先取消关联后再重新关联订单信息 |
| 400 | INVALID_REQUEST | 券已被其他单号关联，请用正确单号重试 | 取消关联接口的报错返回，此类情况是请求中的关联单号与券当前关联的单号不一致，建议调用查询接口查正当前券关联的单号后重试 |
| 400 | INVALID_REQUEST | 商户无权限操作该券 | 仅券的创建方，发送方或归属方商户可以操作该券，请更换商户号调用api |