取消关联订单信息API

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


取消商家券与订单信息的关联关系

注意:

• 建议取消前调用查询接口,查到当前关联的商户单号并确认后,再进行取消操作

接口说明

适用对象:直连商户 服务商 渠道商

请求URL: https://api.mch.weixin.qq.com/v3/marketing/busifavor/coupons/disassociate

请求方式: POST

接口频率: 500QPS

前置条件: 已调用关联接口为券创建过关联关系

接口规则:https://pay.weixin.qq.com/wiki/doc/apiv3/wechatpay/wechatpay-1.shtml


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"
}
    
{
JAVA示例代码
}
    

返回参数

参数名 变量 类型[长度限制] 必填 描述
取消关联成功时间 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"
}

    http://2323weixin.qq.com
                                

错误码公共错误码

状态码 错误码 描述 解决方案
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

版本说明

关闭
V1.0
2020年06月10日
1. 取消关联订单信息接口上线

技术咨询

文档反馈