最新更新時(shí)間:2020.06.10 版本說(shuō)明
將有效態(tài)(未核銷)的商家券與訂單信息關(guān)聯(lián),用于后續(xù)參與搖獎(jiǎng)&返傭激勵(lì)等操作的統(tǒng)計(jì)。
? 僅對(duì)有關(guān)聯(lián)訂單需求的券進(jìn)行該操作
適用對(duì)象: 服務(wù)商
請(qǐng)求URL: https://api.mch.weixin.qq.com/v3/marketing/busifavor/coupons/associate
請(qǐng)求方式: POST
接口頻率: 500QPS
前置條件: 已為用戶發(fā)券,且調(diào)用查詢接口查到用戶的券code、批次ID等信息
path 指該參數(shù)為路徑參數(shù)
query 指該參數(shù)需在請(qǐng)求URL傳參
body 指該參數(shù)需在請(qǐng)求JSON傳參
參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
---|---|---|---|---|
批次號(hào) | stock_id | string[1,20] | 是 | body 微信為每個(gè)商家券批次分配的唯一ID,對(duì)于商戶自定義code的批次,關(guān)聯(lián)請(qǐng)求必須填寫批次號(hào) 示例值:100088 |
券code | coupon_code | string[1,32] | 是 | body 券的唯一標(biāo)識(shí) 示例值:sxxe34343434 |
關(guān)聯(lián)的商戶訂單號(hào) | out_trade_no | string[1,128] | 是 | body 微信支付下單時(shí)的商戶訂單號(hào),欲與該商家券關(guān)聯(lián)的微信支付 示例值:MCH_102233445 |
商戶請(qǐng)求單號(hào) | out_request_no | string[1,128] | 是 | body 商戶創(chuàng)建批次憑據(jù)號(hào)(格式:商戶id+日期+流水號(hào)),商戶側(cè)需保持唯一性,可包含英文字母,數(shù)字,|,_,*,-等內(nèi)容,不允許出現(xiàn)其他不合法符號(hào)。 示例值:1002600620019090123143254435 |
{
"coupon_code" : "sxxe34343434",
"out_trade_no" : "MCH_102233445",
"stock_id" : "100088",
"out_request_no" : "1002600620019090123143254435"
}
參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
---|---|---|---|---|
關(guān)聯(lián)成功時(shí)間 | wechatpay_associate_time | string[1,32] | 是 | 系統(tǒng)關(guān)聯(lián)券成功的時(shí)間,遵循rfc3339標(biāo)準(zhǔn)格式,格式為yyyy-MM-DDTHH:mm:ss+TIMEZONE,yyyy-MM-DD表示年月日,T出現(xiàn)在字符串中,表示time元素的開頭,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秒。 示例值:2015-05-20T13:29:35+08:00 |
{
"wechatpay_associate_time" : "2015-05-20T13:29:35+08:00"
}
狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
---|---|---|---|
400 | PARAM_ERROR | 請(qǐng)求參數(shù)錯(cuò)誤 | 請(qǐng)按照api文檔檢查并更換參數(shù)后重試 |
500 | SYSTEM_ERROR | 系統(tǒng)失敗,請(qǐng)稍后重試 | 請(qǐng)用相同的請(qǐng)求包繼續(xù)重試 |
400 | INVALID_REQUEST | ?券不存在 | ?券不存在,請(qǐng)核實(shí)批次號(hào)&券code后更換請(qǐng)求重試 |
400 | INVALID_REQUEST | 券狀態(tài)非可用態(tài) | 券狀態(tài)非可用態(tài),請(qǐng)核實(shí)批次號(hào)&券code后更換請(qǐng)求重試 |
400 | INVALID_REQUEST | ?券已被其他單號(hào)關(guān)聯(lián) | 關(guān)聯(lián)接口的報(bào)錯(cuò)返回,此類情況是券已關(guān)聯(lián)了其他的單號(hào),請(qǐng)先取消關(guān)聯(lián)后再重新關(guān)聯(lián)訂單信息 |
400 | INVALID_REQUEST | 券已被其他單號(hào)關(guān)聯(lián),請(qǐng)用正確單號(hào)重試 | 取消關(guān)聯(lián)接口的報(bào)錯(cuò)返回,此類情況是請(qǐng)求中的關(guān)聯(lián)單號(hào)與券當(dāng)前關(guān)聯(lián)的單號(hào)不一致,建議調(diào)用查詢接口查正當(dāng)前券關(guān)聯(lián)的單號(hào)后重試 |
400 | INVALID_REQUEST | ?商戶無(wú)權(quán)限操作該券 | 僅券的創(chuàng)建方,發(fā)送方或歸屬方商戶可以操作該券,請(qǐng)更換商戶號(hào)調(diào)用api |