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 Updated | Example |
|---|---|
| Points balance | "You have 450 points" |
| Punch card progress | "3 of 8 stamps collected" |
| Nearby outlet locations | GPS proximity pins on the pass |
| Welcome offer status | Offer redeemed / expired |
When Pushes Are Triggered
Cockato sends wallet push notifications automatically when:
- Points are added or redeemed — via staff checkout or POS transaction
- Punches are added or a reward is redeemed — punch card updates
- Outlet locations change — when a new outlet is added or coordinates updated
- Manual push — from the Wallet Designer page using the "Push Update" button
Platform Differences
| Feature | Apple Wallet | Google Wallet |
|---|---|---|
| Push mechanism | APNs (Apple Push Notification Service) | Google Pay API |
| Device registration | Automatic on pass install | Automatic on pass save |
| Update visibility | Silent refresh | Silent refresh |
| Requires internet | Yes (on device) | Yes (on device) |
| Pass re-download | Not required | Not 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
- Navigate to Wallet Designer
- Scroll to the Push Update section
- Click Push to All Active Passes
- 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