更新钱包卡券（wallet pass），只需在卡券工具中编辑，或通过 API 提交新数据。随后平台会在每台保存了该卡券的设备上刷新卡面，海外用户无需重新安装。在 Apple 上，只有设置了变更消息（change message）的字段才会触发锁屏提醒；在 Google 上，只有会员卡、活动门票和登机牌会收到 Google 自己的提醒。
本文讲的是更新的实操部分。底层机制请阅读钱包卡券更新是如何工作的。示例基于 Pushwoosh Wallet passes：每张卡券都绑定一个 User ID，可以通过编辑器、活动或 API 更新。对于同时运营欧美、东南亚等多个市场的出海团队，这意味着一套数据就能让所有地区用户手中的卡券保持最新。
哪些内容可以修改
几乎所有内容。在 Pushwoosh 的 Apple Wallet 卡券中，您可以编辑卡券名称和描述、字段值和标签、变更消息、颜色、条形码内容、过期日期和状态，以及地点和信标。图片不可修改。在 Google 卡券中，您还可以更换 logo 和主图、条形码、链接以及 App 链接。
只有 1 项是固定的：卡券的样式或类型。店铺卡不能变成优惠券，Google 会员卡也不能变成优惠卡。如果需要换格式，请发放一张新卡券。
| 修改内容 | 示例 | 用户看到的效果 |
|---|---|---|
| 字段值 | 积分从 120 变为 180 | 卡面刷新；如设置了变更消息，还会收到提醒 |
| 日期或时间 | 活动改到晚上 8 点 | 卡面刷新；如设置了变更消息，还会收到提醒 |
| 登机口、座位、站台 | 登机口从 B12 改为 B20 | 卡面刷新；如设置了变更消息，还会收到提醒 |
| 颜色（Google 上还包括图片） | 节日主题设计 | 卡面刷新，无提醒 |
| 地点 | 新门店开业 | 锁屏相关性随之变化，无提醒 |
| 过期或作废 | 会员资格到期 | 卡券变灰或移入已过期 |
单张更新还是全部批量更新
Pushwoosh 中的每张卡券都属于 1 个 User ID，因此有 2 种更新方式。
单张更新是日常场景：一笔消费改变了某位用户的余额，于是这位用户的卡券随之更新。这类更新几乎都应通过 API 或标签同步自动完成，而不是手动点选。
批量更新面向整个计划：新的会员条款，或为所有持卡人换上节日设计，比如双十一或黑五大促期间的主题卡面。在 Pushwoosh 中，这通过 Wallet Pass Campaign（钱包卡券活动）完成。标记为共享（shared）的字段会在该活动发放的所有卡券上同步更新，个人字段则保留每位用户自己的值；保存之前，活动会显示本次修改将影响多少张卡券。
对跨境电商来说，大促季往往是双十一与黑五、Cyber Monday 联动的一整段节奏。可以提前在活动里准备好各个节点的主题卡面，到时只编辑共享字段，所有持卡人的卡券一起切换，大促结束后再换回日常设计。春节期间面向海外华人用户的节日营销，也可以用同样的方式处理。
在 Google Wallet 卡券中，字段可以引用用户标签。Pushwoosh 在创建卡券时填入标签值，并在每次更新时刷新，所以卡面始终显示用户画像中的最新数据。在活动中，标签同步在两个平台上都能做到无需手动编辑：字段背后的标签一旦变化，卡券会在下一次检查时获取新值，默认每 60 分钟检查一次。
变更消息：哪些更新值得打扰用户
并非每次更新都应该打扰用户，由您来决定哪些更新需要提醒。
在 Apple 上，您可以给字段附加一条变更消息，例如“您的登机口已改为 %@”。该字段变化时，iOS 会在锁屏上显示这条消息。没有变更消息的字段会静默更新。
在 Google 上，卡券类型决定了 Google 是否会针对字段变化发送它自己的提醒：只有会员卡、活动门票和登机牌会收到，文案由 Google 撰写。活动门票和航班仅在开始时间不足 3 小时时触发。对于任何类型，您也可以通过 API 或活动为更新附加一条自定义通知。Google 规定每张卡券 24 小时内最多 3 条通知，超出后卡券会静默更新。
我们的经验法则：只对用户需要采取行动的变化发提醒，比如登机口变更、时间调整或积分即将过期。卡面改版或新增门店地点，永远不需要提醒。对于出海游戏的赛事门票或跨境航班这类时间敏感的卡券，提醒尤其要留给真正影响行程的变化。
变更消息不是营销渠道
用字段变更来推送促销很有诱惑力，但不要这样做。Apple 和 Google 只允许与卡券本身相关的通知，例如余额、状态或时间安排；违反这条规则，是让用户删除卡券最快的方式。
促销信息请通过 App 推送、邮件或短信触达同一批用户：每张卡券都绑定一个 User ID，持卡人本来就在您的受众里。当持卡人需要了解卡券本身的消息，比如奖励已可领取，可选方式见向卡券持有人发送消息的文档。
通过 API 更新
当变化来自您自己的系统，比如 POS、预订引擎或积分账本时，请使用 API 而不是编辑器。这也是跨境电商和出海金融科技团队最常见的接入方式：后端数据一变，卡券即刻同步。两个平台的流程相同：定位卡券、发送新值、由平台完成同步。
如果您的出海 App 已经通过 FCM/APNs 向海外用户发送推送，卡券更新不需要另起一套用户体系。卡券与推送共用同一个 User ID，所以触发交易通知推送的同一个后端事件，比如一笔订单付款，也可以同时调用卡券 API 更新余额。
方法和参数见 Apple Wallet PassKit API 和 Google Wallet API 参考文档。
过期、作废与恢复
卡券有生命周期，干净地结束它和开始它同样重要。用户钱包里一张过时的卡，比没有卡更糟。
在 Apple 上，设置过期日期后，卡券会在该日期之后变灰。您也可以把卡券标记为作废（voided），例如优惠券核销之后。在 Google 上，让卡券失效会把它移入用户的已过期卡券（Expired passes），之后还可以重新激活。删除 Google 卡券会在 Google 中使其失效，并删除它在 Pushwoosh 中的记录。
更新没有送达时
大多数情况可以归结为 4 个原因。
Apple 证书过期。Apple 卡券使用您的 Pass Type ID 证书签名，证书一旦过期，卡券就无法签名或更新。上传证书的当天，就把续期日期写进日历。
用户删除了卡券。更新只会送达仍保存着该卡券的设备。
更新已送达，但没有提醒。在 Apple 上，检查该字段是否设置了变更消息；在 Google 上，检查卡券类型、Notify about changed fields 复选框以及每日上限。
用户从未添加卡券。已发放但从未保存的卡券不会收到任何更新。请重新发送安装链接。
用 Pushwoosh 让每张卡券保持最新
Pushwoosh 可以通过编辑器、活动或 API 更新原生 Apple Wallet 和 Google Wallet 卡券，每张卡券与您的推送、邮件和短信共用同一个 User ID。无论是改 1 个余额还是更新整个计划，您都能决定哪些变化值得提醒。平台已通过 ISO 27001:2022 和 SOC 2 Type 2 认证，符合 GDPR 要求，数据中心位于欧盟和美国。
让海外用户及时了解信息，关键不在于发得更多，而在于他们钱包里的那张卡永远准确。
