適用對象：直連商戶 服務商 渠道商
請求URL：https://api.mch.weixin.qq.com/v3/marketing/busifavor/coupons/use
請求方式：POST
接口規(guī)則：http://www.tg885.com/wiki/doc/apiv3/wechatpay/wechatpay-1.shtml
path 指該參數為路徑參數
query 指該參數需在請求URL傳參
body 指該參數需在請求JSON傳參
| 參數名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 券code | coupon_code | string[1,32] | 是 | body
券的唯一標識。 示例值：sxxe34343434 |
| 批次號 | stock_id | string[1,20] | 否 | body 微信為每個商家券批次分配的唯一ID，批次券Code模式是MERCHANT_API或者MERCHANT_UPLOAD時，核銷時必須填寫批次號 示例值：100088 |
| 公眾賬號ID | appid | string[1,32] | 是 | body
支持傳入與當前調用接口商戶號有綁定關系的appid。支持小程序appid與公眾號appid。核銷接口返回的openid會在該傳入appid下進行計算獲得。 示例值：wx1234567889999 |
| 請求核銷時間 | use_time | string[1,32] | 是 | body
商戶請求核銷用戶券的時間。 遵循rfc3339標準格式，格式為yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出現在字符串中，表示time元素的開頭，HH:mm:ss表示時分秒，TIMEZONE表示時區(qū)（+08:00表示東八區(qū)時間，領先UTC 8小時，即北京時間）。例如：2015-05-20T13:29:35.+08:00表示，北京時間2015年5月20日 13點29分35秒。 示例值：2015-05-20T13:29:35+08:00 |
| 核銷請求單據號 | use_request_no | string[1,32] | 是 | body
每次核銷請求的唯一標識，商戶需保證唯一。 示例值：1002600620019090123143254435 |
| 用戶標識 | openid | string[1,128] | 否 | body
用戶的唯一標識，做安全校驗使用，非必填。 示例值：xsd3434454567676 |
{
"coupon_code": "sxxe34343434",
"stock_id": "100088",
"appid": "wx1234567889999",
"use_time": "2015-05-20T13:29:35+08:00",
"use_request_no": "1002600620019090123143254435",
"openid": "xsd3434454567676"
}
| 參數名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 批次號 | stock_id | string[1,20] | 是 | 微信為每個商家券批次分配的唯一ID 示例值：?100088 |
| 用戶標識 | openid | string[1,128] | 是 | 用戶在公眾號內的唯一身份標識。 示例值：dsadas34345454545 |
| 系統核銷券成功的時間 | wechatpay_use_time | string[1,32] | 是 | 系統成功核銷券的時間，遵循rfc3339標準格式，格式為yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出現在字符串中，表示time元素的開頭，HH:mm:ss表示時分秒，TIMEZONE表示時區(qū)（+08:00表示東八區(qū)時間，領先UTC 8小時，即北京時間）。例如：2015-05-20T13:29:35.+08:00表示，北京時間2015年5月20日 13點29分35秒。 示例值：2015-05-20T13:29:35+08:00 |
{
"stock_id": "100088",
"openid": "dsadas34345454545",
"wechatpay_use_time": "2015-05-20T13:29:35+08:00"
}
| 狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 400 | PARAM_ERROR | 參數錯誤 | 查看具體錯誤信息，調整參數 |
| 400 | SYSTEM_ERROR | 系統錯誤 | 請使用相同參數稍后重新調用 |
| 400 | RESOURCE_ALREADY_EXISTS | 批次已存在 | 查看out_request_no字段是否重復使用 |
| 券已被其他訂單核銷 | 請通過查詢券API確認券是否已被其他訂單核銷 | ||
| 404 | RESOURCE_NOT_EXISTS | 查詢的資源不存在 | 請檢查查詢資源的對應id是否填寫正確 |
| 403 | NOAUTH | 無權限 | 查看具體錯誤信息，確認是否有權限 |
| 400 | APPID_MCHID_NOT_MATCH | appid與請求方商戶無關聯關系 | appid與請求方商戶不匹配，請確認appid與請求方商戶是否有關聯關系 |
| 400 | MCH_NOT_EXISTS | 商戶號不存在 | 請確認傳入的商戶號是否正確 |
| 404 | USER_NOT_EXISTS | openid不正確 | 請確認傳入的openid是否正確 |
| 500 | SYSTEM_ERROR | 系統失敗 | 多為網絡超時引起，重試 |
| 429 | FREQUENCY_LIMITED | 頻率限制 | 調用太頻繁，請降低調用接口頻率 |
| 403 | RULELIMIT | 券不在有效期 | 請確認券是否能在當前時間核銷 |
| 400 | INVALID_REQUEST | 發(fā)券模式不合法 | 請更換支持預上傳code的批次后重試 |
| 上傳的自定義code已達上限 | 請更換一個新的批次后重試 |