开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
文档中心
凯发app官方网站的技术支持 & 案例 faq 
支付宝小程序
案例分析
sdk & demo下载
常见问题
常用工具
iot小程序
运维保障
小程序 > 支付宝小程序 > 案例分析 > 小程序卡包uid发券接入流程
贡献者
收藏
我的文档
设置
文档地址
本文介绍支付宝小程序如何以技术方式接入支付宝卡包实现在小程序上 uid 发券,适用于已有小程序,需要技术接入的开发者。 uid 发券组件对接文档内容已整合至 支付宝卡包,请各位开发者根据 支付宝卡包 指引进行开发接入。
开发前准备
更多详情可查看 小程序开发前准备
绑定产品
1创建应用后,在 产品绑定 > 绑定产品 > 找到 基础功能产品,点击 修改

2在权限集中勾选 支付宝卡包,点击 确定

3在选择产品页面,点击 确定,完成产品绑定。

创建卡包模板-发放卡包
创建卡券模板
alipay.pass.template.add(卡券模板创建接口)。 channelid 为小程序的 appid。
bizcontent json 串示例:
说明
模板中的自定义参数以双 $ 符号标志,即 $serialnumber$ 表示自定义参数名为 serialnumber,供发放卡券时使用。
unique_id 参数支付宝有唯一性校验,请保证每次请求该值唯一。
更多 bizcontent 参数详情客户查看 配置券模板内容
小程序端跳转至领卡页面( uid 发券组件
1替换下面连接的 templateid 和 userid 参数,获取 scheme 连接。 alipays://platformapi/startapp?appid=68687143&url=/www/voucher.html?webview_options=abv%3dno%26ttb%3dauto&biztype=svpage&userid=20883024491795&templateid=20180717115730423891234
2小程序端使用 my.ap.navigatetoalipaypage 跳转(打开)至领券前置页,页面唤起调用代码形如: 
用户点击领取后回调callback 地址
用户在发券确认页确认“领取并放入卡包”,页面将直接回调接口该接口进行发券操作。 callback url 回调的样例:
注意:地址必须为 https 协议,表单提交为 get 方法,同时返回商家发券结果,响应数据格式为 json。
调用发券接口进行发券
alipay.pass.instance.add(卡券实例发放接口)。
bizcontent json 串示例:
说明
tpl_params 中的 json 节点即为模板创建时设置的自定义参数(即模板中定义的 $xxxx$ ),每次发券可以自己定义内容,且其中的 serialnumber 支付宝有唯一性校验,每次请求请保证唯一性,不要重复。
tpl_id:调用模板创建接口成功后返回模板 id,该 id 用于发放券票。
recognition_info:支付宝用户识别信息: uid 发券组件h5/小程序 uid 弹窗发券组件
channelid:可设置为 appid(从创建应用处获取)或者 pid。
user_id:通过商户回调 callback 发券接口获得。
user_token:即组件调用开发者在模板配置的 merchant.mcallbackurl 接口,开发者在该接口 url 的 query 参数中获取到的 token。
如出现“领券失败,请稍后重试”的报错信息,则表示 mcallbackurl 响应格式错误,请参考 正确的响应格式
recognition_type为1是通过交易号发券,目前已经不支持使用,请使用 recognition_type:2 。
内容没有解决您的问题?您还可以前往 或 寻求帮助
凯发k8官方网娱乐官方 copyright © 2022 支付宝(杭州)信息技术有限公司  | icp证浙b2-20160559
该文档对你是否有帮助?
当前页面目录
网站地图