创建优惠券

创建卡券接口是微信卡券的基础接口，用于创建一类新的卡券，获取card_id，创建成功并通过审核后，商家可以通过文档提供的其他接口将卡券下发给用户，每次成功领取，库存数量相应扣除。

开发者须知：

  1. 需自定义Code码的商家必须在创建卡券时候，设定use_custom_code为true，且在调用投放卡券接口时填入指定的Code码。指定OpenID同理。特别注意：在公众平台创建的卡券均为非自定义Code类型。
  2. can_share字段指领取卡券原生页面是否可分享，建议指定Code码、指定OpenID等强限制条件的卡券填写false。
  3. 特别注意：编码方式仅支持使用UTF-8，否则会报错。
  4. 创建成功后该卡券会自动提交审核，审核结果将通过事件通知商户。开发者可调用设置白名单接口设置用户白名单，领取未通过审核的卡券，测试整个卡券的使用流程。

EZR券与微信券卡对应及特殊字段说明

EZR：代金券 对应 微信：代金券

参数名 必填 类型 描述
card_type 是 string(24) 类型值：CASH
least_cost 是 int 代金券专用，表示起用金额（单位为分）,如果无起用门槛则填0。
reduce_cost 是 int 代金券专用，表示减免金额。（单位为分）

EZR：折扣券 对应 微信：折扣券

参数名 必填 类型 描述
card_type 是 string(24) 类型值：DISCOUNT
discount 是 int 折扣券专用，表示打折额度（百分比）。填30就是七折。EZR系统需要转换

EZR：礼品券、邀请券 对应 微信：兑换券

参数名 必填 类型 描述
card_type 是 string(24) 类型值：GIFT
gift 是 string(3072) 兑换券专用，取券库的使用说明？

EZR：促销券 对应 微信：优惠券

参数名 必填 类型 描述
card_type 是 string(24) 类型值：GENERAL_COUPON
default_detail 是 string(3072) 优惠券专用，取券库的使用说明？

卡券base_info字段说明

参数名 必填 类型 描述
logo_url 是 string(128) 取品牌logo
code_type 是 string(16) 在业务规则 - 电子券维护配置券核销方式
brand_name 是 string（36） 取品牌名称为商户名字
title 是 string（27） 取优惠券名称，字数上限为9个汉字
color 是 string（16） 在业务规则 - 电子券维护配置券的颜色
notice 是 string（48） 在业务规则 - 电子券维护配置券的使用提醒，默认文本：核销券时请出示二维码
description 是 string（3072） 调用券的使用说明，字数上限为1024个汉字。
sku 是 JSON结构 传 quantity 数量
quantity 是 int 券库存数量，默认传 ？ 张，如果设置了库存的券如何处理？
date_info 是 JSON结构 取活动配置的券有效期，支持固定日期和固定时长（自领取后按天算）
use_custom_code 否 bool 是否自定义Code码，填写true
bind_openid 否 bool 是否指定用户领取，填写true或false ？
use_all_locations 否 bool 如果是通用或线下券显示附近门店
can_share 否 bool 卡券领取页面是否可分享。
can_give_friend 否 bool 活动设置券卡时新增券卡是否可转赠。

券示例

优惠券示例

开发者注意事项

  1. 上传的logo图片限制文件大小限制1MB，像素为300X300，仅支持JPG、PNG格式。
  2. 调用接口获取的logo_url仅支持在微信相关业务下使用。

自定义入口字段说明

场景一：仅卡券被用户领取且处于有效状态时显示（未到有效期、转赠中、核销后不显示）

参数名 必填 类型 描述
center_title 否 string（18） 默认为“立即使用”
center_sub_title 否 string（24） 需要新增券副标题，可填写限制条件
center_url 否 string（128） 显示 code_type 配核销方式及 notice ｜
custom_url_name 否 string（18） 自定义跳转外链的入口名字
custom_url_sub_title 否 string（18） 显示在入口右侧的提示语
custom_url 否 string（128） 自定义跳转的URL ｜

场景二：卡券处于正常状态、转赠中、核销后等异常状态均显示该入口

参数名 必填 类型 描述
center_title 否 string（18） 显示当前券的状态
center_sub_title 否 string（24） 需要新增券副标题，可填写限制条件
center_url 否 string（128） 显示 code_type 配核销方式及 notice ｜
promotion_url_name 否 string（18） 自定义跳转外链的入口名字
promotion_url_sub_title 否 string（18） 显示在入口右侧的提示语
promotion_url 否 string（128） 自定义跳转的URL ｜

不同入口示例：

券入口案例展示

跳转外链带参数说明

为了满足商户基于卡券本身的扩展诉求，允许卡券内页添加url跳转外链。带有的的字段有encrypt_code、card_id。

注意事项： encrypt_code为加密码码，需调用解码接口获取真实Code码。 假如指定的url为http://www.qq.com，用户点击时，跳转的url则为： http://www.qq.com?encrypt_code=ENCRYPT_CODE&card_id=CARDID

results matching ""

    No results matching ""