适用对象: 直连商户
请求URL: https://api.mch.weixin.qq.com/v3/marketing/busifavor/coupons/disassociate
请求方式: POST
接口频率: 500QPS
前置条件: 已调用关联接口为券创建过关联关系
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" : "213dsadfsa",
"out_trade_no" : "treads8a9f980",
"stock_id" : "100088",
"out_request_no" : "fdsafdsafdsa231321"
}
参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
---|---|---|---|---|
取消关联成功时间 | wechatpay_disassociate_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_disassociate_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 |