该产品可以用于管理电子凭证的产品,该产品聚合来自各类生活服务的票据凭证,包括优惠券、折扣券、代金券、换购券、电影票、演出票、火车票、机票。
用户交易创建后,企业或者个人开发者根据交易外部订单号可以通过支付宝提供的开放接口,把卡券添加到支付宝卡包,用户可以通过支付宝钱包客户端,在卡包功能中查看并使用卡券。
一、文档地址
官方文档地址:[url]https://docs.open.alipay.com/199/105248/[/url]
二、开发前准备工作
调用步骤:[url]https://openclub.alipay.com/read.php?tid=12194&fid=69[/url]
注意事项:1、支持沙箱测试;2、不需签约,但需要添加功能;3、支持第三方调用。
检查调用appid的应用功能列表中是否添加“支付宝卡包”。
三、接口集成示例代码
1、设置卡劵样式
(1)点击卡劵中心:[url]https://alipass.alipay.com/index.htm[/url],选择自己想要接入的卡劵模板
(2)根据模板直接下载或者在线编辑卡劵模板
注:在线编辑的卡劵样式下载是点击生成的二维码。
(3)下载卡劵,解压缩,选择pass.json文件(其值即为创建模板的参数tpl_content中content的值)
2、创建卡劵模板
alipay.pass.template.add(支付宝pass创建模板接口):[url]https://openclub.alipay.com/read.php?tid=13240&fid=72[/url]
3、发放卡劵
alipay.pass.instance.add(支付宝pass新建卡券实例接口):[url]https://openclub.alipay.com/read.php?tid=13242&fid=72[/url]
4、核销卡劵
alipay.pass.instance.update(支付宝pass更新卡券实例接口):[url]https://openclub.alipay.com/read.php?tid=13243&fid=72[/url]
5、管理卡劵
alipay.pass.template.update(支付宝pass更新模版接口):[url]https://openclub.alipay.com/read.php?tid=13244&fid=72[/url]
四、注意事项
1、卡劵设计平台
卡劵设计平台只用于设计卡劵样式,在平台编辑生成的二维码进行扫码,目的是查看卡劵样式,无法进行发劵并且核销。
发放卡劵必须调用alipay.pass.template.add(卡券模板创建) 接口进行创建模板后,调用alipay.pass.instance.add(支付宝pass新建卡券实例接口) 。
2、核销方式
支付宝卡劵无法自动核销,必须先核后付,核销和支付是2个动作,即:
(1)调用卡劵更新接口核销卡劵,卡劵页面显示已使用;
(2)支付时,在支付接口的收单金额参数中,传值经过计算的优惠后金额。