接口說明
適用對象：直連商戶 服務商 渠道商
請求URL：https://api.mch.weixin.qq.com/v3/marketing/busifavor/stocks/{stock_id}
請求方式：Patch
前置條件： 已創(chuàng)建商家券批次，且修改時間位于有效期結束時間前
接口規(guī)則：http://www.tg885.com/wiki/doc/apiv3/wechatpay/wechatpay-1.shtml
path 指該參數(shù)為路徑參數(shù)
query 指該參數(shù)為URL參數(shù)
body 指該參數(shù)需在請求JSON傳參
請求參數(shù)
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 批次號 | stock_id | string[1,20] | 是 | path批次號 示例值：101156451224 |
| +自定義入口 | custom_entrance | object | 否 | body卡詳情頁面，可選擇多種入口引導用戶 |
| 商家券批次名稱 | stock_name | string[1,21] | 否 | body批次名稱，字數(shù)上限為21個，一個中文漢字/英文字母/數(shù)字均占用一個字數(shù)。 示例值：8月1日活動券 |
| 批次備注 | comment | string[1,20] | 否 | body僅配置商戶可見，用于自定義信息。字數(shù)上限為20個，一個中文漢字/英文字母/數(shù)字均占用一個字數(shù)。 示例值：活動使用 |
| 適用商品范圍 | goods_name | string[1,15] | 否 | body用來描述批次在哪些商品可用，會顯示在微信卡包中。字數(shù)上限為15個，一個中文漢字/英文字母/數(shù)字均占用一個字數(shù)。 示例值：xxx商品使用 |
| 商戶請求單號 | out_request_no | string[1,128] | 是 | body商戶修改批次憑據(jù)號（格式：商戶id+日期+流水號），商戶側需保持唯一性。 示例值：6122352020010133287985742 |
| +樣式信息 | display_pattern_info | object | 否 | body創(chuàng)建批次時的樣式信息。 |
| +核銷規(guī)則 | coupon_use_rule | object | 否 | body券核銷相關規(guī)則 |
| +發(fā)放規(guī)則 | stock_send_rule | object | 否 | body券發(fā)放相關規(guī)則 |
| +事件通知配置 | notify_config | object | 否 | body事件回調通知商戶的配置 |
卡券背景顏色圖
請求示例
{
"custom_entrance": {
"mini_programs_info": {
"mini_programs_appid": "wx234545656765876",
"mini_programs_path": "/path/index/index",
"entrance_words": "歡迎選購",
"guiding_words": "獲取更多優(yōu)惠"
},
"appid": "wx324345hgfhfghfg",
"hall_id": "233455656",
"code_display_mode": "BARCODE"
},
"stock_name": "8月1日活動券",
"comment": "活動使用",
"goods_name": "xxx商品使用",
"out_request_no": "6122352020010133287985742",
"display_pattern_info": {
"description": "xxx門店可用",
"merchant_logo_url": "https://xxx",
"merchant_name": "微信支付",
"background_color": "xxxxx",
"coupon_image_url": "圖片cdn地址"
},
"coupon_use_rule": {
"use_method": "OFF_LINE",
"mini_programs_appid": "wx23232232323",
"mini_programs_path": "/path/index/index"
},
"stock_send_rule": {
"natural_person_limit": false,
"prevent_api_abuse": false
},
"notify_config": {
"notify_appid": "wx23232232323"
}
}
錯誤碼公共錯誤碼
| 狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 400 | INVALID_REQUEST | 修改跳轉到小程序的自定義入口請?zhí)钊胄〕绦騛ppid | 需要修改小程序自定義入口，請?zhí)钊胝_的小程序appid |
| 404 | RESOURCE_NOT_EXISTS | 批次不存在 | 請檢查批次id后重試 |
| 403 | RULELIMIT | 修改流程中僅允許創(chuàng)建方進行操作 | 僅允許調用方進行修改，請更換調用api的商戶號 |
| 400 | INVALID_REQUEST | 修改字段中包含敏感詞 | 請更換提示的敏感詞字段后重試 |
| 404 | RESOURCE_NOT_EXISTS | 修改的appid不合法 | 請更換正確的appid后重試 |
| 400 | INVALID_REQUEST | 修改的appid與商戶號沒有綁定關系 | 請更換正確的appid后重試 |
| 404 | RESOURCE_NOT_EXISTS | 營銷館id不存在 | 請更換正確的營銷館id后重試 |
| 403 | RULELIMIT | 修改的營銷館無權限 | 請更換正確的營銷館id后重試 |
| 400 | INVALID_REQUEST | 修改的圖片url包含敏感內容 | 請更換待修改圖片后重試 |