最新更新時間:2020.06.10 版本說明
取消商家券與訂單信息的關聯(lián)關系
? 建議取消前調用查詢接口,查到當前關聯(lián)的商戶單號并確認后,再進行取消操作
適用對象:直連商戶 服務商 渠道商
請求URL: https://api.mch.weixin.qq.com/v3/marketing/busifavor/coupons/disassociate
請求方式: POST
接口頻率: 500QPS
前置條件: 已調用關聯(lián)接口為券創(chuàng)建過關聯(lián)關系
接口規(guī)則:http://www.tg885.com/wiki/doc/apiv3/wechatpay/wechatpay-1.shtml
path 指該參數(shù)為路徑參數(shù)
query 指該參數(shù)需在請求URL傳參
body 指該參數(shù)需在請求JSON傳參
參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
---|---|---|---|---|
批次號 | stock_id | string[1,20] | 是 | body微信為每個商家券批次分配的唯一ID, 對于商戶自定義code的批次,關聯(lián)請求必須填寫批次號 示例值:100088 |
券code | coupon_code | string[1,32] | 是 | body 券的唯一標識 示例值:sxxe34343434 |
關聯(lián)的商戶訂單號 | out_trade_no | string[1,128] | 是 | body 微信支付下單時的商戶訂單號,欲與該商家券關聯(lián)的微信支付 示例值:MCH_102233445 |
商戶請求單號 | out_request_no | string[1,128] | 是 | body 商戶創(chuàng)建批次憑據號(格式:商戶id+日期+流水號),商戶側需保持唯一性,可包含英文字母,數(shù)字,|,_,*,-等內容,不允許出現(xiàn)其他不合法符號。 示例值:1002600620019090123143254435 |
{
"coupon_code" : "213dsadfsa",
"out_trade_no" : "treads8a9f980",
"stock_id" : "100088",
"out_request_no" : "fdsafdsafdsa231321"
}
參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
---|---|---|---|---|
取消關聯(lián)成功時間 | wechatpay_disassociate_time | string[1,32] | 是 | 系統(tǒng)成功取消商家券與訂單信息關聯(lián)關系的時間,遵循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秒。 示例值:2015-05-20T13:29:35+08:00 |
{
"wechatpay_disassociate_time" : "2015-05-20T13:29:35+08:00"
}
狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
---|---|---|---|
400 | PARAM_ERROR | 請求參數(shù)錯誤 | 請按照api文檔檢查并更換參數(shù)后重試 |
500 | SYSTEM_ERROR | 系統(tǒng)失敗,請稍后重試 | 請用相同的請求包繼續(xù)重試 |
400 | INVALID_REQUEST | ?券不存在 | ?券不存在,請核實批次號&券code后更換請求重試 |
400 | INVALID_REQUEST | 券狀態(tài)非可用態(tài) | 券狀態(tài)非可用態(tài),請核實批次號&券code后更換請求重試 |
400 | INVALID_REQUEST | ?券已被其他單號關聯(lián) | 關聯(lián)接口的報錯返回,此類情況是券已關聯(lián)了其他的單號,請先取消關聯(lián)后再重新關聯(lián)訂單信息 |
400 | INVALID_REQUEST | 券已被其他單號關聯(lián),請用正確單號重試 | 取消關聯(lián)接口的報錯返回,此類情況是請求中的關聯(lián)單號與券當前關聯(lián)的單號不一致,建議調用查詢接口查正當前券關聯(lián)的單號后重試 |
400 | INVALID_REQUEST | ?商戶無權限操作該券 | 僅券的創(chuàng)建方,發(fā)送方或歸屬方商戶可以操作該券,請更換商戶號調用api |