最新更新時間：2020.05.12 版本說明
商戶通過調(diào)用本接口向用戶發(fā)放消費(fèi)卡，用戶領(lǐng)到卡的同時會領(lǐng)取到一批代金券，消費(fèi)卡會自動放入卡包中。
? 調(diào)用該接口前，需要在微信支付商戶平臺創(chuàng)建“消費(fèi)卡”，獲得card_id。
? 此功能僅向指定邀約商戶開放，如有需要請聯(lián)系微信支付運(yùn)營經(jīng)理。
適用對象：直連商戶
請求URL：https://api.mch.weixin.qq.com/v3/marketing/busifavor/coupons/{card_id}/send
請求方式：POST
接口規(guī)則：http://www.tg885.com/wiki/doc/apiv3/wechatpay/wechatpay-1.shtml
path指該參數(shù)為路徑參數(shù)
query指該參數(shù)需在請求URL傳參
body指該參數(shù)需在請求JSON傳參
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 消費(fèi)卡ID | card_id | string[1,28] | 是 | path
消費(fèi)卡ID，即card_id。card_id獲取方法請參見《接入流程》中的創(chuàng)建消費(fèi)卡。 示例值：pIJMr5MMiIkO_93VtPyIiEk2DZ4w |
| 消費(fèi)卡歸屬appid | appid | string[1,18] | 是 | query 消費(fèi)卡card_id 歸屬appid，需與api調(diào)用方商戶號有M-A綁定關(guān)系，需和創(chuàng)建消費(fèi)卡信息中填入的歸屬appid一致。入?yún)⒅械挠脩鬿penid也需用此appid生成。 示例值：wxc0b84a53ed8e8d29 |
| 用戶openid | openid | string[1,28] | 是 | query 待發(fā)卡用戶的openid，需為消費(fèi)卡歸屬appid生成的openid。 示例值：obLatjhnqgy2syxrXVM3MJirbkdI |
| 商戶單據(jù)號 | out_request_no | string[1,32] | 是 | query 商戶此次發(fā)放憑據(jù)號。推薦使用大小寫字母和數(shù)字，不同添加請求發(fā)放憑據(jù)號不同，商戶側(cè)需保證同一發(fā)券請求的out_request_no和send_time的唯一性。 示例值：oTYhjfdsahnssddj_0136 |
| 請求發(fā)卡時間 | send_time | string[1,32] | 是 | query 單次請求發(fā)卡時間，消費(fèi)卡在商戶系統(tǒng)的實(shí)際發(fā)放時間，為東八區(qū)標(biāo)準(zhǔn)時間（UTC+8）。商戶需保證同一次請求的out_request_no和send_time唯一。由于系統(tǒng)限制，暫不支持傳入早于當(dāng)前時間24小時以上的時間進(jìn)行發(fā)券請求。 示例值：2019-12-31T13:29:35.120+08:00 |
{
"send_time": "2019-12-31T13:29:35.120+08:00",
"openid": "obLatjhnqgy2syxrXVM3MJirbkdI",
"appid": "wxc0b84a53ed8e8d29",
"out_request_no": "oTYhjfdsahnssddj_0136"
}
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 消費(fèi)卡code | card_code | string[1,15] | 是 | 發(fā)卡成功后，每個用戶在每個card_id下會分配一個唯一code。 示例值：198555211279 |
{
"card_code" : "198555211279"
} | 狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 400 | PARAM_ERROR | 請求參數(shù)錯誤 | 請按照API文檔檢查并更換參數(shù)后重試 |
| 400 | PARAM_ERROR | 發(fā)券時間早于當(dāng)前時間24h | 請更換當(dāng)前時間24h內(nèi)的send_time |
| 500 | SYSTEM_ERROR | 系統(tǒng)失敗 | 消費(fèi)卡插入用戶卡包失敗，請稍后使用原訂單號重試 |
| 400 | INVALID_REQUEST | 用戶領(lǐng)卡數(shù)目超過限額 | 用戶已領(lǐng)取消費(fèi)卡數(shù)目超過card_id“用戶可領(lǐng)個數(shù)”限制，請更換其他用戶 |
| 400 | INVALID_REQUEST | 用戶或該用戶的其他微信號領(lǐng)取消費(fèi)卡數(shù)目已超過當(dāng)前活動限制 | 用戶本人或同一用戶的其他微信號（綁定了同一個實(shí)名用戶銀行卡的微信）已領(lǐng)取過消費(fèi)卡，請更換其他用戶發(fā)券 |
| 400 | INVALID_REQUEST | 商戶未創(chuàng)建過該消費(fèi)卡活動 | 商戶id未開通消費(fèi)卡發(fā)放權(quán)限，或card_id與商戶id不匹配，請查正后重試 |
| 400 | INVALID_REQUEST | 消費(fèi)卡庫存已發(fā)完 | 消費(fèi)卡card_id發(fā)放總個數(shù)已發(fā)完，請更換其他card_id發(fā)券 |
| 400 | INVALID_REQUEST | 消費(fèi)卡card_id已過期 | 消費(fèi)卡card_id已過期，請更換后重試 |
| 400 | INVALID_REQUEST | 消費(fèi)卡card_id狀態(tài)失效 | 消費(fèi)卡card_id狀態(tài)失效，請核實(shí)后重試 |