优惠券接入流程

步骤一：商户在支付宝alipass平台配置优惠券模板（商户配置操作），得到模板ID，提供给支付宝运营同学

步骤二：提供优惠券码（商户自定义，支持数字、字母）,建议券码为数字与字母混杂无规律的组合，长度在10位以上，避免被恶意刷码（商户提供），以CSV的文本格式提供给支付宝运营同学配置活动

步骤三：活动期间，支付宝通过指定渠道，使用该券模板下发优惠券给到指定支付宝用户

步骤四：用户点击立即使用优惠券，跳转商户活动引导页，用户下单支付流程中，若需获取用户授权信息实现免登，可接入用户信息授权接口（商户开发）

步骤五：用户完成支付，商户调用支付宝外部商户券码券核销（alipay.marketing.voucher.stock.use） 将卡券核销（商户开发），需限制只能使用支付宝支付方式

接入总流程图

券模板配置流程

(1) 使用签约支付宝账号登录alipass平台 ,首页选择优惠券模板，进行编辑

(2) 配置卡券的有效时间,将生效时间设置成$activeTime$，失效时间配置设置成$expireTime$，活动时间由营销平台后台设置：

(3) 设置券核销方式
B2C线上商户一般场景是跳转服务窗链接访问商户H5页面，并将券码传递过去进行核销：

- 选中操作区域，核销模式选择“自定义核销模式”
- 展示类型选择“链接”
- 辅助文字用于链接按钮的文字显示，可填写如“立即使用”字样
- 链接地址需要配置服务窗或生活号跳转链接（点击默认关注或者手动关注服务窗或生活号），并将券码传递到商户H5上
链接示例：alipays://platformapi/startApp?appId=20000042&publicId=2014090900011083&followType=PUBLIC&sourceId=publicIndexList&actionType=WebView&fromppdetailwebview=YES&url=http%3a%2f%2fm.shanghu.com%2faliCard%2findex%3fsn%3d$entityNum$
其中：
- publicId改为商户服务窗的APPID
- url改为编码过的商户H5页面地址，其中包含参数$entityNum$，即为该优惠券券码。（注意$entityNum$中的$不能编码，因为营销平台会先将$entityNum$替换为券码）

(4) 生成券模板二维码:
点击保存并生成二维码，会出现二维码，支付宝钱包扫该二维码可以在支付宝钱包内查看最新版钱包支持的优惠券样式；PS：样式以钱包中展示为准

(5) 获取优惠券模板ID
进入我的alipass，找到配置的模板，获取相应的模板ID；PS：如果模板要调整，建议尽量新建模板，原有模板变动会导致所有以此模板生成的券样式变动。

其他核销场景介绍

(1) 线下门店机具核销：
模板中展示类型设置为条码，二维码，声波，在线下门店购物核销，可以将卡券的核销码（卡密）展示给线下收银员，收银员可以通过机具获取核销码（卡密）信息同步到后台，将相应的券进行核销

(2) 线下PC端核销：
模板中展示类型设置为文本，到店支付核销时，展示券码信息给线下收银员，收银员记录卡密内容到PC端进行核销（前提是PC端有相应的核销平台）

(3) 链接访问核销：
在链接的后面加上自定义字段$entityNum$，支付宝营销中心发券时会将这个参数赋值，用户进入钱包卡券点击链接的过程中会带上卡密内容，到指定页面之后get卡密参数值

该场景区别于服务窗或生活号跳转链接之处在于，用户不会跳转服务窗或生活号进行关注操作

商户H5页面改造

当券使用场景为跳转商户H5页面进行购买核销时，需要对商户H5页面流程做一定改造。

(1) 用户点击立即使用，建议跳转配置到一个活动引导页面，以便用户理解，并注意透传保存券码entityNum

(2) 用户下单购买，透传券码entityNum，通过券码判断，在商户收银台露出优惠券抵扣信息，引导用户支付

(3) 用户提交订单支付，唤起用户登录流程，建议接入支付宝用户信息授权实现免登，新用户唤起授权流程，获取支付宝可提供信息注册，缺失的必须信息通过补全页面用户输入，并关联支付宝uid；老用户通过uid直接免登操作，文档参考：
https://doc.open.alipay.com/docs/doc.htm?spm=a219a.7629140.0.0.rtwJUx&treeId=193&articleId=105656&docType=1

(4) 登录后将优惠券与该用户关联，用户支付时需要限制只能使用支付宝支付

H5页面改造流程图：

卡券更新接口开发

若商户系统需要核销券，用户使用优惠券在商家处核销时，需立即调用支付宝外部商户券码券核销（alipay.marketing.voucher.stock.use） 将卡券核销，外部商户券码券核销接口文档

使用外部商户券码券核销接口条件：
（1） 需要使用配置alipass券的支付宝账号登录开发平台相应应用下，添加功能“无资金商户优惠券”，如何添加功能
（2） 外部商户券码券核销接口入参entity_no的值传入用户的券核销码值，即为H5页面跳转中，带入的$entityNum$值，进行匹配核销

测试及上线

目前运营这边可提供的测试途径包括：

（1） 配置刮刮卡测试页面，需要商户提供优惠券模板ID，券码（卡密）和商户PID给到支付宝运营
（2） 配置优惠券兑换测试页面，需要商户提供优惠券模板ID，券码（卡密）和商户PID给到支付宝运营
（3） 指定测试用户发送卡券，需要商户提供用户uid，优惠券模板ID，券码（卡密）和商户PID给到支付宝运营

具体使用哪种测试方式，视实际情况与支付宝运营同学确认，提供相关信息

FAQ

关于此文档暂时还没有FAQ