小程序运营工具提供了有礼系列工具(如分享有礼,会员有礼等)结合分享、收藏以及支付宝会员等场景,为商户提供自运营能力。商户可以通过创建权益,结合小程序自运营场景,实现小程序的拉新、留存及促活。但以上自运营能力所创建的权益,均为支付宝优惠券,即仅可在支付宝收银台核销的优惠券,并且权益形式有限,无法满足商户多样的权益诉求。并且商户会根据其服务内容以及投入产出情况,创建适用于商户平台的优惠券,提高商户创建权益的灵活性,因此引入券码券的能力,来实现接入商户优惠券,由支付宝平台发放,商户自主核销。
什么是券码券
券码券是一种优惠券类型,商户将其券平台的优惠券以券码的方式导出并导入支付宝生成券码券,通过券码的方式实现与商户券平台的映射关系。支付宝通过发放券码券,实现对商户券的发放,商户根据访问用户绑定使用的券码,实现商户权益的发放。
券码券接入流程
在配置使用券码券之前,可以参考以下流程:
准备工作
商户接入券码券之前,需要将其平台优惠券以券码的形式导出。
导出的券码不可以重复,重复的券码会被平台识别为一张优惠券。
发布后自动解码,预计不超过 2 小时;券码仅支持英文大小写、数字、特殊字符- = /支持扩展名:.csv;单个券码的长度不超过 128 个字符;文件大小不能超过 90m,最多支持 1000 万条数据。
在有礼活动中配置券码券
登录 > 我的应用列表中,找到需要创建营销活动的小程序,小程序需要处于已上架状态。
点击进入小程序后,在 营销转化 中,点击 小程序营销。
商户在以下有礼活动中可以以直领券码券作为奖品。
小程序中领权益
收藏小程序领权益
分享领权益
关注领权益
在配置的活动规则页面,基础设置 > 选择权益 > 在弹出的权益类型选项框中选择 券码券 类型。
进入选择权益内容页面,点击 新建券码券。
进入优惠券配置页面,填写券信息,设置券的领取条件以及券的使用方式。
使用设置表单填写说明:
券名称:展示给用户的优惠券的名称,如 5 元代金券,汉堡 5 折折扣券等。
券码文件:即商户券码列表,系统是基于该文件中包含的券码值来确定券数量的,并且为 c 端用户发放即商户上传的券码。券码发布后开始自动解码,预计不超过 2 小时;文件大小不能超过 90m,最多支持 1000 万条数据券码仅支持英文大小写、数字、特殊字符- = /单个券码的长度不超过 128 个字符。
券使用有效期:即用户领券以后的券可核销时间范围,仅在该时间范围内优惠券可用。
核销方式
二维码 条形码:即用户需要在卡包中展示当前优惠券的券码值,商户可以通过扫码枪扫码后讲优惠券核销,该核销方式更适用于线下场景。
跳转至商家指定页面:可以跳转至商户小程序指定页面后引导用户核销优惠券,该核销方式更适用于线上场景。选择后,需要配置页面链接,在链接中填写核销优惠券小程序的相关页面。链接格式参考:alipays://platformapi/startapp?appid=123&query=${data}。在链接中query=${data}参数是必填内容,作用是:用户点击立即使用跳转至小程序的链接中会携带当前用户身上绑定的券码,商户可以通过识别券码来核销用户领取的商户优惠券。
回调地址:回调地址用于接收支付宝为用户发放优惠券成功后的通知消息,该消息为后端消息,而跳转页面携带的参数是前端链接中携带的信息。
开发者appid:回调数据时, 支付宝需要获取该 appid 的私钥加签, 商户需要通过该 appid 的公钥进行验签。
使用说明:即在支付宝卡包查看优惠券时展示给用户的优惠券使用说明。
在技术接入前,可以参考以下用户领取券码及使用流程:
消息监听
商户同步券码后,通过有礼活动发放给用户的是商户同步的券码,可以理解为这张券码是用户去商户端兑换优惠券的一张凭证,因此需要商户通过用户领取到的券码,在商户端为用户进行商户优惠券发放的动作。因此商户需要设置一个回调地址,作用即有礼发放券码给到用户后,通过该回调地址通知商户优惠券的发放情况。
异步通知参数
以下异步参数为当前需要关注的所有参数,除以下参数外若出现其他异步参数可忽略。
参数 | 参数名称 | 范例 |
notify_type | 通知类型 | vcc_voucher_flux_notify |
uid | 用户id | |
alipay_biz_no | 业务单号 | 201908080007301168420001sy6d |
biz_time | 优惠券券发放时间 | 2019-08-08 15:47:24 |
entity_num | 券码码值 | jewqr432142314asdfasd11werqwerwrqwr |
flux_amount | 数量 | 1.00 |
template_id | 券模板id | 201908080007300183580000jsqx |
voucher_id | 券id | 201908080007300268420002igjm |
卡券链接解析
由于用户存在领取商户多张券码券的可能,因此用户如果从卡包点击进入商户小程序,商户需要感知用户当前使用的券码信息。商户在配置券码券时,配置好立即使用跳转地址参数,用户点击卡券使用跳转到小程序页面即会携带券码参数,如:alipays://platformapi/startapp?appid=123&query=${data},前端可以根据query携带的券码参数进行解析,匹配商户优惠券,从而准确核销用户当前使用的优惠券。
商户在小程序中核销用户优惠券后,需要同时将商户优惠券对应的券码券核销掉,根据当前用户领取商户优惠券对应的券码调用券码券核销接口进行核销,接口文档请参考:。