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