適用對(duì)象：直連商戶 服務(wù)商 渠道商
請(qǐng)求URL：https://api.mch.weixin.qq.com/v3/marketing/busifavor/coupons/deactivate
請(qǐng)求方式：POST
前置條件：券的狀態(tài)為SENDED
接口規(guī)則：http://www.tg885.com/wiki/doc/apiv3/wechatpay/wechatpay-1.shtml
path 指該參數(shù)為路徑參數(shù)
query 指該參數(shù)為URL參數(shù)
body 指該參數(shù)需在請(qǐng)求JSON傳參
| 參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 券code | coupon_code | string[1,32] | 是 | body券的唯一標(biāo)識(shí) 示例值：sxxe34343434 |
| 批次號(hào) | stock_id | string[1,20] | 是 | body券的所屬批次號(hào) 示例值：1234567891 |
| 失效請(qǐng)求單據(jù)號(hào) | deactivate_request_no | string[1, 128] | 是 | body每次失效請(qǐng)求的唯一標(biāo)識(shí)，商戶需保證唯一 示例值：1002600620019090123143254436 |
| 失效原因 | deactivate_reason | string[1, 64] | 否 | body商戶失效券的原因 示例值：此券使用時(shí)間設(shè)置錯(cuò)誤 |
{
"coupon_code": "sxxe34343434",
"stock_id": "1234567891",
"deactivate_request_no": "1002600620019090123143254436",
"deactivate_reason": "此券使用時(shí)間設(shè)置錯(cuò)誤"
}
| 參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 券成功失效的時(shí)間 | wechatpay_deactivate_time | string[1,32] | 是 | 系統(tǒng)券成功失效的時(shí)間，遵循rfc3339標(biāo)準(zhǔn)格式，格式為yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出現(xiàn)在字符串中，表示time元素的開(kāi)頭，HH:mm:ss表示時(shí)分秒，TIMEZONE表示時(shí)區(qū)（+08:00表示東八區(qū)時(shí)間，領(lǐng)先UTC 8小時(shí)，即北京時(shí)間）。例如：2015-05-20T13:29:35+08:00表示，北京時(shí)間2015年5月20日 13點(diǎn)29分35秒。 示例值：2020-05-20T13:29:35.08:00 |
{
"wechatpay_deactivate_time": "2020-05-20T13:29:35.120+08:00"
}
| 狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 404 | RESOURCE_NOT_EXISTS | 批次不存在 | 請(qǐng)檢查批次id |
| 404 | RESOURCE_NOT_EXISTS | 券不存在 | 請(qǐng)檢查券code |
| 403 | RULELIMIT | 券不屬于指定的批次 | 券不屬于指定的批次 |
| 403 | RULELIMIT | 僅批次創(chuàng)建方有權(quán)限使券失效 | 僅批次創(chuàng)建方有權(quán)限使券失效 |
| 403 | RULELIMIT | 券已被核銷 | 只能失效狀態(tài)為SENDED的券 |
| 404 | RESOURCE_NOT_EXISTS | 券已被刪除 | 只能失效狀態(tài)為SENDED的券 |
| 403 | RULELIMIT | 券已過(guò)期，不能再進(jìn)行其他操作 | 只能失效狀態(tài)為SENDED的券 |