適用對象:直連商戶 服務(wù)商 渠道商
請求URL:https://api.mch.weixin.qq.com/v3/marketing/busifavor/coupons/return
請求方式:POST
前置條件:券的狀態(tài)為USED
接口規(guī)則:http://www.tg885.com/wiki/doc/apiv3/wechatpay/wechatpay-1.shtml
path 指該參數(shù)為路徑參數(shù)
query 指該參數(shù)為URL參數(shù)
body 指該參數(shù)需在請求JSON傳參
參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
---|---|---|---|---|
券code | coupon_code | string[1,20] | 是 | body券的唯一標(biāo)識 示例值:sxxe34343434 |
批次號 | stock_id | string[1,32] | 是 | body券的所屬批次號 |
退券請求單據(jù)號 | return_request_no | string[1, 128] | 是 | body每次退券請求的唯一標(biāo)識,商戶需保證唯一 示例值:1002600620019090123143254436 |
{
"coupon_code": "sxxe34343434",
"stock_id": "",
"return_request_no": "1002600620019090123143254436"
}
參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
---|---|---|---|---|
微信退券成功的時間 | wechatpay_return_time | string[1,32] | 是 | 微信退券成功的時間,遵循rfc3339標(biāo)準(zhǔn)格式,格式為yyyy-MM-DDTHH:mm:ss+TIMEZONE,yyyy-MM-DD表示年月日,T出現(xiàn)在字符串中,表示time元素的開頭,HH:mm:ss表示時分秒,TIMEZONE表示時區(qū)(+08:00表示東八區(qū)時間,領(lǐng)先UTC 8小時,即北京時間)。例如:2015-05-20T13:29:35+08:00表示,北京時間2015年5月20日 13點29分35秒。 示例值:2020-05-20T13:29:35+08:00 |
{
"wechatpay_return_time": "2020-05-20T13:29:35.120+08:00"
}
狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
---|---|---|---|
404 | RESOURCE_NOT_EXISTS | 券不存在 | 請檢查券code |
403 | NOAUTH | 商戶無權(quán)限操作該券 | 請確認(rèn)調(diào)用API商戶號 |
404 | RESOURCE_NOT_EXISTS | 券已被刪除 | 請查詢?nèi)斍榇_認(rèn)券當(dāng)前狀態(tài) |
403 | RULELIMIT | 券當(dāng)前是可用的 | 請查詢?nèi)斍榇_認(rèn)券當(dāng)前狀態(tài) |
400 | RESOURCE_ALREADY_EXISTS | 已使用過此單號退券 | 請更換單號重試 |
403 | RULELIMIT | 券已不在使用有效期 | 券已不在使用有效期,不可退 |