电商集成Google Wallet后，如何通过FCM推送通行证更新通知？

核心逻辑说明 #

Google Wallet本身已集成FCM作为推送通道，无需你直接调用FCM API。只需在更新通行证（会员卡/优惠券）时，通过Google Wallet Passes API触发推送即可。

步骤1：确认前置条件 #

• 已完成Google Wallet商户账号配置，且成功集成Passes API（用于管理通行证的创建、更新）
• 用户已将目标通行证添加至其Google Wallet账户

步骤2：触发更新与推送的核心操作 #

当积分到账、等级提升、通行证过期等事件发生时，后端调用Google Wallet的更新接口，并开启推送开关：

示例：更新会员卡积分并触发推送（curl请求）

curl -X PATCH https://walletobjects.googleapis.com/walletobjects/v1/loyaltyObject/{你的会员卡ID} \
-H "Authorization: Bearer {你的OAuth2访问令牌}" \
-H "Content-Type: application/json" \
-d '{
  "loyaltyPoints": {
    "balance": {
      "intValue": "1800"
    }
  },
  "sendNotification": true
}'

• 关键参数：sendNotification: true，设置后Google Wallet会自动通过FCM向用户推送更新通知

步骤3：自定义通知内容（可选） #

若需要自定义通知的标题和正文，可在更新请求中添加notification字段：

{
  "loyaltyPoints": {
    "balance": {
      "intValue": "1800"
    }
  },
  "sendNotification": true,
  "notification": {
    "title": "积分到账通知",
    "body": "您的账户新增300积分，当前总积分1800"
  }
}

• 注意：通知内容需符合Google规范，标题不超过40字符，正文不超过120字符

步骤4：排查常见问题 #

• 未收到通知：检查sendNotification是否设为true；确认通行证状态为active；验证用户设备已登录Google账号并开启推送权限
• 通知内容不符：检查notification字段格式是否正确，字符长度是否合规
• API调用失败：确认OAuth2令牌拥有walletobjects.editor或更高权限，检查请求URL中的通行证ID是否正确

内容的提问来源于stack exchange，提问作者Ali Dbouk