微信平台开发者创建卡券

由 如此轻盈 创建，Carrie 最后一次修改 2016-09-27 更新日志版本号更新内容更新时间V1.8普通券支持图文详情，对齐朋友的券；2015-2-16V1.9普通券支持使用条件字段，开发者创建卡券时须注意使用条件字段，商户填入对应字段时，系统将在卡面拼出使用的条件；若不填写时，将拼接“无最低消费限制，全场通用，不限品类”并在使用条件中拼写“可与其他优惠共享”，详情请见：普通券支持使用条件的通知2016-5-26V2.0创建/更新卡券支持设置卡券支持“全部门店”字段，商户门店变更自动同步到卡券上2016-6-271 更新通知2016年5月15日起，微信卡券团队对会员卡能力进行全面升级。在原有能力基础上进行以下能力升级，旨在帮助商家更好地进行会员管理。-强化客户端一级入口：会员到店即用，快速定位商户会员卡；-自定义卡面能力：开发者可以根据会员身份设置不同的卡面背景；-门店扫码方案：新用户到店扫码领卡，老用户到店扫码快速打开会员卡，实现会员点餐、买单等多种功能-支付即会员：支持开发者设置微信支付后为用户下发领卡消息，顾客支付即会员，快速拉新；-运营策略调整：会员卡新增开放类目限制，自4月20日起，仅限会员卡类目内的商户新建会员卡，原有会员卡不受影响，详情请见：《会员卡公告》2 创建卡券2.1 接口调用顺序2.2 接口调用说明在进行卡券创建前，请开发者根据自身业务场景确定以下几点2.2.1 明确卡券ID与Code码的区别创建卡券成功后获取卡券ID，一个卡券ID代表一类卡券，包含相应库存数量的Code码。 例如： 创建50元代金券，获取一个卡券ID（card_id）用于投放，并设置库存100万。顾客小A，领取到商户投放的50元代金券时，券面上会有一个唯一的标识码，即code码。每个用户的code码都不相同，所以该商户最终卡券发放完毕时，微信将会派发100万个不同的code码给用户。参数名描述card_id卡券ID。一个卡券ID对应一类卡券，包含了相应库存数量的Code码。code卡券Code码。一张卡券的唯一标识，核销卡券时使用此串码，支持商户自定义。2.2.2 是否自定义Code码微信卡券的Code码可由微信后台随机分配，同时支持商户自定义，两者的区别如下：类别使用场景创建投放核销自定义Code码通常为商户在现有业务已有一套Code码体系。"use_custom_code"：true，仅支持API创建。卡券投放接口中填入code字段值。仅支持调用API接口核销。非自定义Code码可使用微信的Code码体系完成投放、核销。"use_custom_code"：false，支持API创建、公众平台创建（默认为非自定义Code码）。卡券投放接口中无需填写code字段，由微信后台分配。支持卡券核销助手公众号核销、公众平台网页核销、API接口核销。导入code模式商户须用自己的code码体系，且要通过微信渠道下发卡券（如：二维码/群发／货架等）"use_custom_code":true且get_custom_code_mode:"GET_CUSTOM_CODE_MODE_DEPOSIT"卡券侧随机在导入的code中下发，不可指定，投放接口不可传code字段核销时许同时传入card_id和code，仅支持API备注：自定义code码的开发者若想要获得和非自定义code商户相同的群发卡券、客服消息派发卡券的能力。可以通过导入自定义code接口将非定义code导入到微信服务器，若仅在h5投放则无须导入，导入code后code由微信随机下发，不可指定。2.2.3 选择合适的码型商户可以根据自身的业务模式和能支持的核销方式，选择合适的券面码型，并在创建卡券填入code_type字段。举例：若A商户选了二维码类型的卡券，则A商户的核销员在核销时可以通过手机商户助手扫码核销卡券；若B商户选择了仅code类型的码型，则其核销员就只能通过输入串号的方式核销卡券。类别字段名适用核销方式二维码/一维码显示codeCODE_TYPE_QRCODE/CODE_TYPE_BARCODE适用于扫码/输码核销二维码不显示codeCODE_TYPE_ONLY_QRCODE仅适用于扫码核销仅code类型CODE_TYPE_TEXT仅适用于输码核销无code类型CODE_TYPE_NONE仅适用于线上核销，开发者须自定义跳转链接跳转至H5页面，允许用户核销掉卡券，自定义cell的名称可以命名为“立即使用”2.2.4 记录用户领券行为记录用户领券行为有多种方式：1. 用户领取卡券后会推送事件通知开发者，领取卡券事件中包含卡券ID、Code码、领取人OpenID、转赠人OpenID。卡券被核销时同样会推送事件，详情见卡券事件通知。2. 调用查询Code接口获取该Code码的状态（是否被领取、核销、删除），若Code码被用户领取且处于有效状态，可获取领券人OpenID。3. 从卡券详情页跳转外部链接时，微信后台会自动带上卡券ID、Code码等信息，详情见跳转外链带参数说明。4. 在卡券投放接口中加入场景字段outer_str，该字段值会在用户领取时伴随事件通知商户。例如：创建二维码接口时设置outer_str为1，添加卡券JS-SDK时设置为2，则可通过对领取事件的分析得出两个不同投放渠道带来的领券效果，及时调整投放策略。2.2.5 活用自定义入口为满足商户功能扩展的需求，新增可自定义两个卡券内的入口，支持跳转到商户自定义的HTML5网页。 三个自定义入口基于不同的场景定位设置，区别如下：类别示例字段显示逻辑使用场景入口立即使用center_title、center_sub_title、center_url仅卡券被用户领取且处于有效状态时显示（未到有效期、转赠中、核销后不显示）。服务场景入口在线商城custom_url_name、custom_url_sub_title、custom_url仅卡券被用户领取且处于有效状态时显示（转赠中、核销后不显示）。营销场景入口再次购买promotion_url_name、promotion_url_sub_title、promotion_url卡券处于正常状态、转赠中、核销后等异常状态均显示该入口。不同入口示例：2.3 步骤一：上传卡券图片素材  为了保证商户的卡券在用户的微信内能快速、稳定地加载出图片素材，我们强烈建议开发者将商户的卡券素材先调用接口导入微信CDN。2.3.1 上传图片接口开发者需调用该接口上传商户图标至微信服务器，获取相应logo_url/icon_list/image_url，用于卡券创建。开发者注意事项1.上传的图片限制文件大小限制1MB，仅支持JPG、PNG格式。2.调用接口获取图片url仅支持在微信相关业务下使用。接口调用请求说明HTTP请求方式: POST/FROMURL:https://api.weixin.qq.com/cgi-bin/media/uploadimg?access_token=ACCESS_TOKEN参数说明参数是否必须说明buffer是文件的数据流acc