Wallet Push Notifications

Wallet Push Notifications

Wallet push notifications let you silently update the data displayed on a customer's Apple or Google Wallet loyalty card — no app required. When you push an update, the card on the customer's device refreshes automatically.

What Gets Updated via Push

Push notifications do not send a visible alert to the customer's lock screen. Instead, they trigger a background refresh of the wallet pass data:

Field UpdatedExample
Points balance"You have 450 points"
Punch card progress"3 of 8 stamps collected"
Nearby outlet locationsGPS proximity pins on the pass
Welcome offer statusOffer redeemed / expired

When Pushes Are Triggered

Cockato sends wallet push notifications automatically when:

  1. Points are added or redeemed — via staff checkout or POS transaction
  2. Punches are added or a reward is redeemed — punch card updates
  3. Outlet locations change — when a new outlet is added or coordinates updated
  4. Manual push — from the Wallet Designer page using the "Push Update" button

Platform Differences

FeatureApple WalletGoogle Wallet
Push mechanismAPNs (Apple Push Notification Service)Google Pay API
Device registrationAutomatic on pass installAutomatic on pass save
Update visibilitySilent refreshSilent refresh
Requires internetYes (on device)Yes (on device)
Pass re-downloadNot requiredNot required

Viewing Push Logs

Super Admins can inspect push delivery history at SAAS Admin → Push Logs.

Each log entry shows:

  • Timestamp of the push attempt
  • Platform (Apple / Google)
  • Customer ID and pass object ID
  • Success or error status
  • HTTP response from the wallet provider

💡 Tip: If a push shows an error, the most common causes are an expired device token (customer uninstalled and reinstalled the pass) or a network timeout at the wallet provider.

Manual Push from Wallet Designer

  1. Navigate to Wallet Designer
  2. Scroll to the Push Update section
  3. Click Push to All Active Passes
  4. Confirm the action — all customers with active passes will receive the update

This is useful after making visual or data changes to the wallet template.

Troubleshooting

Push shows as delivered but card didn't update:

  • The device may be offline. The update is queued and will apply when connectivity is restored.

High error rate in push logs:

  • Check that your Apple Wallet certificate and Google Pay issuer credentials are valid in Settings → Wallet.

Customer says their card is out of date:

  • Use the manual push from Wallet Designer, or ask the customer to open and close the Wallet app to force a refresh.

Ready to get started?

Try Cockato for free and see how it can help grow your business.

Get Started Free