接口說(shuō)明
適用對(duì)象： 直連商戶
請(qǐng)求URL：https://api.mch.weixin.qq.com/v3/marketing/busifavor/stocks/{stock_id}
請(qǐng)求方式：GET
path 指該參數(shù)為路徑參數(shù)
query 指該參數(shù)需在請(qǐng)求URL傳參
body 指該參數(shù)需在請(qǐng)求JSON傳參
請(qǐng)求參數(shù)
| 參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 批次號(hào) | stock_id | string[1,20] | 是 | path 微信為每個(gè)商家券批次分配的唯一ID 示例值：1212 |
請(qǐng)求示例
https://api.mch.weixin.qq.com/v3/marketing/busifavor/stocks/1212
返回參數(shù)
| 參數(shù)名 | 變量 | 類型[長(zhǎng)度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 商家券批次名稱 | stock_name | string[1,21] | 是 | 批次名稱，字?jǐn)?shù)上限為21個(gè)，一個(gè)中文漢字/英文字母/數(shù)字均占用一個(gè)字?jǐn)?shù)。 示例值：8月1日活動(dòng)券 |
| 批次歸屬商戶號(hào) | belong_merchant | string[8,15] | 是 | 批次歸屬于哪個(gè)商戶。 示例值：10000022 |
| 批次備注 | comment | string[1,20] | 否 | 僅配置商戶可見(jiàn)，用于自定義信息。字?jǐn)?shù)上限為20個(gè)，一個(gè)中文漢字/英文字母/數(shù)字均占用一個(gè)字?jǐn)?shù)。 示例值：活動(dòng)使用 |
| 適用商品范圍 | goods_name | string[1,15] | 是 | 用來(lái)描述批次在哪些商品可用，會(huì)顯示在微信卡包中。字?jǐn)?shù)上限為15個(gè)，一個(gè)中文漢字/英文字母/數(shù)字均占用一個(gè)字?jǐn)?shù)。 示例值：xxx商品使用 |
| 批次類型 | stock_type | string[1,16] | 是 | 批次類型 NORMAL：固定面額滿減券批次 DISCOUNT：折扣券批次 EXCHANGE：換購(gòu)券批次 示例值：NORMAL |
| +核銷規(guī)則 | coupon_use_rule | object | 是 | 券核銷相關(guān)規(guī)則 |
| +發(fā)放規(guī)則 | stock_send_rule | object | 是 | 券發(fā)放相關(guān)規(guī)則 |
| +自定義入口 | custom_entrance | object | 否 | 卡詳情頁(yè)面，可選擇多種入口引導(dǎo)用戶。 |
| +樣式信息 | display_pattern_info | object | 否 | 創(chuàng)建批次時(shí)的樣式信息。 |
| 批次狀態(tài) | stock_state | string[1,128] | 是 | 批次狀態(tài)
示例值：RUNNING |
| 券code模式 | coupon_code_mode | string[1,128] | 是 | 枚舉值： WECHATPAY_MODE：系統(tǒng)分配券code。 MERCHANT_API：商戶發(fā)放時(shí)接口指定券code。 MERCHANT_UPLOAD：商戶上傳自定義code，發(fā)券時(shí)系統(tǒng)隨機(jī)選取上傳的券code。 示例值：WECHATPAY_MODE |
| 批次號(hào) | stock_id | string[1,20] | 是 | 微信為每個(gè)商家券批次分配的唯一ID。 示例值：1212 |
| +券code數(shù)量 | coupon_code_count | object | 否 | 當(dāng)且僅當(dāng)coupon_code_mode（券code模式）為MERCHANT_UPLOAD（商戶上傳自定義code）模式時(shí)，返回該字段，返回內(nèi)容為商戶上傳code的數(shù)量信息。 |
| +事件通知配置 | notify_config | object | 否 | 事件回調(diào)通知商戶的配置。 |
| +批次發(fā)放情況 | send_count_information | object | 否 | 批次發(fā)放情況 |
卡券背景顏色圖
商家券詳情信息樣式圖
返回示例
{
"stock_name": "8月1日活動(dòng)券",
"belong_merchant": "10000022",
"comment": "xxx店使用",
"goods_name": "xxx商品使用",
"stock_type": "NORMAL",
"coupon_use_rule": {
"coupon_available_time": {
"available_begin_time": "2015-05-20T13:29:35+08:00",
"available_end_time": "2015-05-20T13:29:35+08:00",
"available_day_after_receive": 3,
"available_week": {
"week_day": [
1,
2
],
"available_day_time": [
{
"begin_time": 3600,
"end_time": 86399
}
]
},
"irregulary_avaliable_time": [
{
"begin_time": "2015-05-20T13:29:35+08:00",
"end_time": "2015-05-20T13:29:35+08:00"
}
]
},
"fixed_normal_coupon": {
"discount_amount": 5,
"transaction_minimum": 100
},
"use_method": "OFF_LINE",
"mini_programs_appid": "wx23232232323",
"mini_programs_path": "/path/index/index"
},
"stock_send_rule": {
"max_amount": 100000,
"max_coupons": 100,
"max_coupons_per_user": 5,
"max_amount_by_day": 1000,
"max_coupons_by_day": 100,
"natural_person_limit": false,
"prevent_api_abuse": false,
"transferable": false,
"shareable": false
},
"custom_entrance": {
"mini_programs_info": {
"mini_programs_appid": "wx234545656765876",
"mini_programs_path": "/path/index/index",
"entrance_words": "歡迎選購(gòu)",
"guiding_words": "獲取更多優(yōu)惠"
},
"appid": "wx324345hgfhfghfg",
"hall_id": "233455656",
"store_id": "233554655"
},
"display_pattern_info": {
"description": "xxx門店可用",
"merchant_logo_url": "https://xxx",
"merchant_name": "微信支付",
"background_color": "Color020",
"coupon_image_url": "https://qpic.cn/xxx",
"finder_info": {
"finder_id": "sph6Rngt2T4RlUf",
"finder_video_cover_image_url": "https://wxpaylogo.qpic.cn/xxx",
"finder_video_id": "export/UzFfAgtgekIEAQAAAAAAb4MgnPInmAAAAAstQy6ubaLX4KHWvLEZgBPEwIEgVnk9HIP-zNPgMJofG6tpdGPJNg_ojtEjoT94"
}
},
"stock_state": "RUNNING",
"coupon_code_mode": "MERCHANT_UPLOAD",
"stock_id": "1212",
"coupon_code_count": {
"total_count": 100,
"available_count": 50
}
}
錯(cuò)誤碼公共錯(cuò)誤碼
| 狀態(tài)碼 | 錯(cuò)誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 400 | PARAM_ERROR | 參數(shù)錯(cuò)誤 | 查看具體錯(cuò)誤信息，調(diào)整參數(shù) |
| 400 | SYSTEM_ERROR | 系統(tǒng)錯(cuò)誤 | 請(qǐng)使用相同參數(shù)稍后重新調(diào)用 |
| 400 | RESOURCE_ALREADY_EXISTS | 批次已存在 | 查看out_request_no字段是否重復(fù)使用 |
| 券已被其他訂單核銷 | 請(qǐng)通過(guò)查詢?nèi)疉PI確認(rèn)券是否已被其他訂單核銷 | ||
| 404 | RESOURCE_NOT_EXISTS | 查詢的資源不存在 | 請(qǐng)檢查查詢資源的對(duì)應(yīng)id是否填寫正確 |
| 403 | NOAUTH | 無(wú)權(quán)限 | 查看具體錯(cuò)誤信息，確認(rèn)是否有權(quán)限 |
| 400 | APPID_MCHID_NOT_MATCH | appid與請(qǐng)求方商戶無(wú)關(guān)聯(lián)關(guān)系 | appid與請(qǐng)求方商戶不匹配，請(qǐng)確認(rèn)appid與請(qǐng)求方商戶是否有關(guān)聯(lián)關(guān)系 |
| 400 | MCH_NOT_EXISTS | 商戶號(hào)不存在 | 請(qǐng)確認(rèn)傳入的商戶號(hào)是否正確 |
| 404 | USER_NOT_EXISTS | openid不正確 | 請(qǐng)確認(rèn)傳入的openid是否正確 |
| 500 | SYSTEM_ERROR | 系統(tǒng)失敗 | 多為網(wǎng)絡(luò)超時(shí)引起，重試 |
| 429 | FREQUENCY_LIMITED | 頻率限制 | 調(diào)用太頻繁，請(qǐng)降低調(diào)用接口頻率 |
| 403 | RULELIMIT | 券不在有效期 | 請(qǐng)確認(rèn)券是否能在當(dāng)前時(shí)間核銷 |
| 400 | INVALID_REQUEST | 發(fā)券模式不合法 | 請(qǐng)更換支持預(yù)上傳code的批次后重試 |
| 上傳的自定義code已達(dá)上限 | 請(qǐng)更換一個(gè)新的批次后重試 |