失效一張券，券被失效后無法再被核銷
# 接口說明
支持商戶：
【普通服務商】【渠道商】
請求方式：
【POST】/v3/marketing/busifavor/coupons/deactivate
請求域名：
【主域名】
https://api.mch.weixin.qq.com
使用該域名將訪問就近的接入點【備域名】
https://api2.mch.weixin.qq.com
使用該域名將訪問異地的接入點 ，指引點擊查看
# 請求參數(shù)
- Authorization 必填 string請參考 簽名認證 生成認證信息
- Accept 必填 string請設置為
application/json - Content-Type 必填 string請設置為
application/json
Header HTTP頭參數(shù)
- coupon_code 必填 string【券code】 券的唯一標識
- stock_id 必填 string【批次號】 券的所屬批次號
- deactivate_request_no 必填 string(128)【失效請求單據(jù)號】 每次失效請求的唯一標識，商戶需保證唯一
- deactivate_reason 選填 string(64)【失效原因】 商戶失效券的原因
Body 包體參數(shù)
請求示例
POST
# 應答參數(shù)
- wechatpay_deactivate_time 必填 string【系統(tǒng)失效成功的時間】 系統(tǒng)券成功失效的時間，遵循rfc3339
標準格式，格式為yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出現(xiàn)在字符串中，表示time元素的開頭，HH:mm:ss表示時分秒，TIMEZONE表示時區(qū)（+08:00表示東八區(qū)時間，領先UTC 8小時，即北京時間）。例如：2015-05-20T13:29:35+08:00表示，北京時間2015年5月20日 13點29分35秒。
200OK
應答示例
200 OK
# 錯誤碼
# 公共錯誤碼
| 狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 400 | PARAM_ERROR | 參數(shù)錯誤 | 請根據(jù)錯誤提示正確傳入?yún)?shù) |
| 400 | INVALID_REQUEST | HTTP 請求不符合微信支付 APIv3 接口規(guī)則 | 請參閱 接口規(guī)則 |
| 401 | SIGN_ERROR | 驗證不通過 | 請參閱 簽名常見問題 |
| 500 | SYSTEM_ERROR | 系統(tǒng)異常，請稍后重試 | 請稍后重試 |
# 業(yè)務錯誤碼
| 狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 403 | RULELIMIT | 券不屬于指定的批次 | 券不屬于指定的批次 |
| 403 | RULELIMIT | 僅批次創(chuàng)建方有權限使券失效 | 僅批次創(chuàng)建方有權限使券失效 |
| 403 | RULELIMIT | 券已被核銷 | 只能失效狀態(tài)為SENDED的券 |
| 403 | RULELIMIT | 券已過期，不能再進行其他操作 | 只能失效狀態(tài)為SENDED的券 |
| 404 | RESOURCE_NOT_EXISTS | 批次不存在 | 請檢查批次ID |
| 404 | RESOURCE_NOT_EXISTS | 券不存在 | 請檢查券code |
| 404 | RESOURCE_NOT_EXISTS | 券已被刪除 | 只能失效狀態(tài)為SENDED的券 |
