Wallet 卡券
Apple Wallet 和 Google Wallet 中的会员卡始终放在顾客的手机里:卡上显示积分余额、等级、当前有效的优惠码以及结账用的条形码。OneTrace.pro 会自动更新会员卡:下单、获得积分或发放优惠码后,顾客会看到新的数值,Apple Wallet 还会显示通知。会员卡也是一个消息渠道:简短的消息以通知形式送达,并保留在卡片背面。
Wallet 卡券从“增长版”套餐起提供(套餐)。在菜单中打开用户互动 → Wallet 卡券。“经理”“观察者”及以上角色可以查看统计和卡券外观,有权管理集成的角色(“管理员”和“所有者”)可以修改外观。
连接
会员卡由您的店铺以自己的名义、使用自己的 Apple 和 Google 密钥发放。连接其中一个或两个平台:
- 打开集成,点击添加集成 → Wallet 卡券(集成)。
- Apple Wallet:
- 在 Apple Developer 中打开 Certificates, Identifiers & Profiles → Identifiers,注册一个 Pass Type ID,例如
pass.com.example.loyalty; - 为其创建 Pass Type ID Certificate 证书,安装到 Mac 上,然后在“钥匙串访问”中将证书连同私钥导出为
.p12文件; - 在 Pass Type ID 证书字段中粘贴 base64 编码的
.p12内容,或 PEM 格式的证书和私钥,在密钥密码字段中填写导出密码。Apple WWDR 中间证书由 OneTrace.pro 自动添加。
- 在 Apple Developer 中打开 Certificates, Identifiers & Profiles → Identifiers,注册一个 Pass Type ID,例如
- Google Wallet:
- 在 Google Pay & Wallet Console 中创建发卡方,并复制 Issuer ID;
- 在 Google Cloud 中启用 Google Wallet API,创建服务账号及其 JSON 密钥;
- 在 Google Pay & Wallet Console 中将服务账号的邮箱添加为发卡方用户;
- 将 Issuer ID 和 JSON 密钥粘贴到集成中。
- 点击保存和测试:对于 Apple,测试会显示 Pass Type ID、团队和证书有效期;对于 Google,会显示卡券类别已创建。
在 Google 批准您的发卡方发布之前,只有在控制台中添加的测试用户才能保存 Google 卡券。Apple 证书有效期为一年:请在到期前签发新证书并在集成中替换,否则会员卡将停止更新。
卡券外观
打开 Wallet 卡券,或在集成中点击卡券设计。如果有多个集成,请在顶部选择所需的集成。
| 字段 | 作用 |
|---|---|
| 卡面名称 | 发卡的商店。留空则使用集成名称 |
| 背景、文字、标签 | 卡片颜色。Google Wallet 只使用背景色,文字颜色由其自动选择 |
| 徽标 | Apple:位于左上角,替代名称显示。请上传不小于 480×150 像素的图片 |
| 横幅 | Apple:徽标下方、积分背后的宽幅图片;Google:卡券顶部。约 1125×369 像素 |
| 图标 | 不小于 660×660 像素的正方形:用作 Apple 通知图标和 Google Wallet 中的计划徽标 |
| 条形码 | 二维码、Code 128、PDF417 或 Aztec,取决于收银台扫码器能识别哪种。条形码中是卡号 |
| 自定义字段 | 最多 4 个字段:卡面标签和档案属性,例如“城市”— city。档案没有该属性时,其卡券上也不显示此字段 |
图片从媒体库中选择,为此需要有消息模板的访问权限。卡券正在使用的图片无法从媒体库中删除。右侧是使用示例数据的预览;通过切换可以查看卡券在 Apple Wallet 和 Google Wallet 中的效果。预览仅为大致效果:实际外观取决于手机。
点击保存。顾客已安装的卡券将在几分钟内更新。


卡上显示什么
- 积分和等级:来自顾客在会员积分计划中的账户。
- 姓名:来自
first_name和last_name属性。 - 优惠码:发放给顾客且尚未使用的最近一个专属优惠码。
- 卡号和条形码。如果档案已有会员卡号(标识符
loyalty_card,例如来自线下小票),Wallet 卡券使用同一个卡号;否则 OneTrace.pro 会生成一个新的 13 位卡号。 - 外观中的自定义字段和最近一条消息:显示在卡片背面。
当积分、等级、姓名、自定义字段或优惠码发生变化时,卡券会更新。Apple Wallet 会就新的余额、等级和优惠码显示通知。如果两个档案合并为一个,卡券会转移到保留的档案。
顾客如何添加卡券
卡券通过个人专属链接发放:这是您品牌域名上的一个页面,带有添加到 Apple 钱包和添加到 Google 钱包按钮。打开页面所用平台的按钮会显示在最前面。链接有效期为 90 天,页面使用档案的语言。
- 在邮件和其他消息中:使用变量
{{ wallet_url }}(模板),例如在会员积分计划的欢迎旅程中。 - 在订阅偏好中心中:钱包中的会员卡链接。
- 在店铺的个人中心中:使用具有“读取档案”权限的私密密钥调用
GET /api/v1/profiles/{type}/{value}/wallet(API 密钥),返回链接及其有效期、平台和档案的卡券。
当项目中有已启用、带 Apple 证书或 Google 密钥的“Wallet 卡券”集成时,才会生成该链接。
向卡券发送消息
Wallet 卡券渠道与其他渠道一样,可用于模板、旅程和群发,支持 A/B 变体和投递状态。模板中有标题(卡片背面字段的标签)、文本和可选的链接,均可使用变量。
- Apple Wallet 以通知形式显示文本,并将其保留在卡片背面,直到下一条消息。手机获取更新后的卡券时,消息即视为已送达。
- Google Wallet 会将消息添加到卡券并发送通知。Google 每张卡券每天最多显示 3 条通知。
只有安装了该集成卡券的顾客才能收到消息。如果没有卡券,发送会以“该档案没有已安装的 Wallet 卡券”错误结束。请使用条件或分群,只向持有卡券的顾客发送 Wallet 消息。
统计
卡券统计模块按平台显示:
- 已发放:通过链接创建了多少张卡券;
- 已安装:目前顾客的 Wallet 中有多少张卡券;
- 已删除:有多少顾客移除了卡券。
下方图表按项目时区显示 30 天内每天的安装数和删除数。

在档案卡片中,Wallet 卡券模块显示顾客的卡券:平台、卡号和日期,即卡券的安装、删除时间,或已发放但未安装的时间。