支付宝小程序：有礼接入券码券

产品概述

小程序运营工具提供了有礼系列工具（如分享有礼，会员有礼等）结合分享、收藏以及支付宝会员等场景，为商户提供自运营能力。商户可以通过创建权益，结合小程序自运营场景，实现小程序的拉新、留存及促活。但以上自运营能力所创建的权益，均为支付宝优惠券，即仅可在支付宝收银台核销的优惠券，并且权益形式有限，无法满足商户多样的权益诉求。并且商户会根据其服务内容以及投入产出情况，创建适用于商户平台的优惠券，提高商户创建权益的灵活性，因此引入券码券的能力，来实现接入商户优惠券，由支付宝平台发放，商户自主核销。

券码券是一种优惠券类型，商户将其券平台的优惠券以券码的方式导出并导入支付宝生成券码券，通过券码的方式实现与商户券平台的映射关系。支付宝通过发放券码券，实现对商户券的发放，商户根据访问用户绑定使用的券码，实现商户权益的发放。

目前券码券仅对白名单用户开放，如有需要请将小程序名称、PID，联系方式，发送邮件到[email protected] 以申请白名单权限，邮件名前缀务必注明【券码券白名单】XXX小程序，申请一般在3个工作日内完成处理。

在配置使用券码券之前，可以参考以下流程：

alipays://platformapi/startapp?appId=123&query=${data}。在链接中query=${data}参数是必填内容，作用是：用户点击立即使用跳转至小程序的链接中会携带当前用户身上绑定的券码，商户可以通过识别券码来核销用户领取的商户优惠券。

在技术接入前，可以参考以下用户领取券码及使用流程：

关于支付宝异步通知那些事。

以下异步参数为当前需要关注的所有参数，除以下参数外若出现其他异步参数可忽略。

由于用户存在领取商户多张券码券的可能，因此用户如果从卡包点击进入商户小程序，商户需要感知用户当前使用的券码信息。商户在配置券码券时，配置好立即使用跳转地址参数，用户点击卡券使用跳转到小程序页面即会携带券码参数，如：alipays://platformapi/startapp?appId=123&query=${data}，前端可以根据query携带的券码参数进行解析，匹配商户优惠券，从而准确核销用户当前使用的优惠券。

商户在小程序中核销用户优惠券后，需要同时将商户优惠券对应的券码券核销掉，根据当前用户领取商户优惠券对应的券码调用券码券核销接口进行核销，接口文档请参考：外部商户券码券核销。