文档中心 > alipass营销配券

内部核销券接入流程

更新时间:2017/03/29 访问次数:1155

整体接入流程:

步骤一:商户在支付宝alipass平台配置优惠券模板(商户配置操作),得到模板ID,提供给支付宝运营同学
步骤二:活动期间,支付宝通过指定渠道,使用该券模板下发优惠券给到指定支付宝用户
步骤三:用户点击立即使用优惠券,跳转商户活动引导页,用户下单支付流程中,若需获取用户授权信息实现免登,可接入用户信息授权接口(商户开发
步骤四:用户选择支付宝支付,支付宝收银台自动核销券,商户可申请开通对应异步通知字段(线下当面付除外),用于判断订单是否使用了优惠券(商户开发

总流程图:

image

券模板配置流程

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

(2) 配置卡券的有效时间
将生效时间和失效时间配置成卡密的有效时间(具体的活动时间):
image

(3) 设置券核销方式
B2C线上商户一般场景是跳转商户H5活动页面:
-选中操作区域,核销模式选择“自定义核销模式
-展示类型选择“链接”
-辅助文字用于链接按钮的文字显示,可填写如“立即使用”字样
-链接地址配置商户H5活动页地址,链接示例:http://m.shanghu.com/huodong
若需设置跳转生活号链接访问商户H5页面,并默认关注生活号(需联系运营申请配置)需配置如下示例链接地址
链接示例:alipays://platformapi/startApp?appId=20000042&publicId=2014090900011083&followType=PUBLIC&sourceId=publicIndexList&actionType=WebView&fromppdetailwebview=YES&url=http%3a%2f%2fm.shanghu.com%2fhuodong
其中:1.publicId改为商户服务窗的APPID; 2.url改为编码过的商户H5页面地址
image
PS:线下场景,门店使用当面付进行付款时,支付宝收银台也可自动关联优惠券核销

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

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

商户端开发事项:

商户客户端开发事项:

当券使用场景为跳转商户H5页面进行购买核销时,需要对商户H5页面流程做一定改造:
(1) 用户使用优惠券,点击立即使用,建议跳转配置到一个活动引导页面,以便用户理解,
(2) 用户提交订单支付,唤起用户登录流程,建议接入支付宝用户信息授权实现免登,新用户唤起授权流程,获取支付宝可提供信息注册,缺失的必须信息通过补全页面用户输入,并关联支付宝uid;老用户通过uid直接免登操作,文档参考:
https://doc.open.alipay.com/docs/doc.htm?spm=a219a.7629140.0.0.rtwJUx&treeId=193&articleId=105656&docType=1
PS:优惠券使用场景,要求支付方式限制只能使用支付宝

商户服务端开发事项:

商户系统若需要判断订单是否使用优惠券,需针对不同支付渠道,做相应开发处理
支持营销券的下单接口如下:

接口名 接口类型 备注
create_direct_pay_by_user 1.0接口 PC即时到账
alipay.trade.app.pay 2.0接口 无线app
mobile.securitypay.pay 1.0接口 无线app
alipay.trade.wap.pay 2.0接口 无线wap
alipay.wap.create.direct.pay.by.user 1.0接口 无线wap
alipay.wap.trade.create.direct 1.0接口 无线wap

以上接口

-同步返回通知无差异:不返回券相关信息,商户需要依赖异步通知
-异步通知的差异:新增通知参数用于区分是否使用优惠券,这些参数默认都不返回,若需要返回,请向对应的技术支持按需申请配置
参数如下列表

字段名 字段含义 是否新增
out_channel_type 支付渠道组合信息 否(取值参考原文档)
fund_bill_list 支付金额信息
voucher_detail_list 优惠券信息
receipt_amount 商家实际收款金额
invoice_amount 可开具发票金额
buyer_pay_amount 用户支付金额
point_amount 积分宝支付金额

具体取值参考:
https://doc.open.alipay.com/doc2/detail.htm?treeId=203&articleId=105286&docType=1

FAQ

关于此文档暂时还没有FAQ
返回
顶部