適用場(chǎng)景:將有效態(tài)(未核銷)的商家券與訂單信息關(guān)聯(lián),用于后續(xù)參與搖獎(jiǎng)&返傭激勵(lì)等操作的統(tǒng)計(jì)
適用對(duì)象:如普通服務(wù)商、普通直連商戶
頻率:500QPS
前置條件:已為用戶發(fā)券,且調(diào)用查詢接口查到用戶的券code、批次ID等信息
注意事項(xiàng):僅對(duì)有關(guān)聯(lián)訂單需求的券進(jìn)行該操作
是否支持冪等:是
# 接口說(shuō)明
支持商戶:
【普通商戶】
請(qǐng)求方式:
【POST】/v3/marketing/busifavor/coupons/associate
請(qǐng)求域名:
【主域名】
https://api.mch.weixin.qq.com
使用該域名將訪問(wèn)就近的接入點(diǎn)【備域名】
https://api2.mch.weixin.qq.com
使用該域名將訪問(wèn)異地的接入點(diǎn) ,指引點(diǎn)擊查看
# 請(qǐng)求參數(shù)
- Authorization 必填 string請(qǐng)參考 簽名認(rèn)證 生成認(rèn)證信息
- Accept 必填 string請(qǐng)?jiān)O(shè)置為
application/json
- Content-Type 必填 string請(qǐng)?jiān)O(shè)置為
application/json
Header HTTP頭參數(shù)
- stock_id 必填 string【批次號(hào)】 微信為每個(gè)商家券批次分配的唯一ID,對(duì)于商戶自定義code的批次,關(guān)聯(lián)請(qǐng)求必須填寫(xiě)批次號(hào)
- coupon_code 必填 string【券code】 券的唯一標(biāo)識(shí)
- out_trade_no 必填 string(128)【關(guān)聯(lián)的商戶訂單號(hào)】 微信支付下單時(shí)的商戶訂單號(hào),欲與該商家券關(guān)聯(lián)的微信支付
- out_request_no 必填 string(128)【請(qǐng)求業(yè)務(wù)單據(jù)號(hào)】 商戶創(chuàng)建批次憑據(jù)號(hào)(格式:商戶ID+日期+流水號(hào)),商戶側(cè)需保持唯一性,可包含英文字母,數(shù)字,|,_,*,-等內(nèi)容,不允許出現(xiàn)其他不合法符號(hào)。
Body 包體參數(shù)
請(qǐng)求示例
POST
# 應(yīng)答參數(shù)
- wechatpay_associate_time 必填 string【關(guān)聯(lián)成功時(shí)間】 系統(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元素的開(kāi)頭,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秒。
200OK
應(yīng)答示例
200 OK
# 錯(cuò)誤碼
# 公共錯(cuò)誤碼
狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
---|---|---|---|
400 | PARAM_ERROR | 參數(shù)錯(cuò)誤 | 請(qǐng)根據(jù)錯(cuò)誤提示正確傳入?yún)?shù) |
400 | INVALID_REQUEST | HTTP 請(qǐng)求不符合微信支付 APIv3 接口規(guī)則 | 請(qǐng)參閱 接口規(guī)則 |
401 | SIGN_ERROR | 驗(yàn)證不通過(guò) | 請(qǐng)參閱 簽名常見(jiàn)問(wèn)題 |
500 | SYSTEM_ERROR | 系統(tǒng)異常,請(qǐng)稍后重試 | 請(qǐng)稍后重試 |
# 業(yè)務(wù)錯(cuò)誤碼
狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
---|---|---|---|
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 |