WalletWallet API

Campaigns

One message on every lock screen.

Write the notification, pick the passes by search or by a list of serials, send it now or at a time you choose, and see how many phones it reached.

Saturday 14 November

9:41

BCBayroast CoffeenowDouble stamps all day Saturday.

A membership program tested one push, then updated all 82 of its passes in 14 seconds.

What people send

One message to the passes you pick, on the lock screen of every phone that holds one.

Renewal reminders

Search the members whose cards expire next month and tell them to renew. The message lands on the lock screen, next to the card it is about.

Offers to loyalty cards

Double stamps on Saturday, a new flavour, a birthday treat. Every card on a phone gets it, with no app and no email list.

Event and webinar reminders

A reminder the morning of the event or an hour before a webinar goes live, so more of the people who signed up show up. Push a venue or link change the same way.

Win back quiet customers

Search the passes that have not been updated in months and send one message to bring them back in.

From a message to every phone

  1. Up to 60 characters, shown on a phone as you type. The sender name and icon come from each pass, or you set one for the whole campaign.

  2. Search the way you do in Pass Manager and tick the rows or add every match, or upload a CSV of serials and see which ones matched.

  3. Send it right away or pick a date and time. A scheduled campaign can be edited, sent early, or cancelled until it runs.

  4. Each campaign reports how many passes were notified, skipped, or failed, and how many devices got the push, with a CSV per recipient. Duplicate it to send again.

Tips from customers

What customers learned from their first campaigns.

  • A pass that already shows the same text is skipped. To send a message again, change the wording.

    A restaurant group

  • Google Wallet delivers up to three notifications per pass in 24 hours. Later updates still arrive, without a banner.

    A bubble tea loyalty platform

  • One VIP pass sits on 1,384 iPhones and 577 Android phones. A weekly offer is scheduled to it, and same-day pushes go out alongside.

    A sports venue

How a campaign works

60 characters

Short enough to read on a lock screen in one glance. A phone preview shows the Apple and the Google version as you type.

Recipients three ways

A search over every field, ticked rows, or a CSV of serials. The upload reports which serials matched and which were not found.

Passes per campaign

1,000 on Pro, 5,000 on Business, 10,000 on Scale, with no limit on the number of campaigns.

Scheduled up to a year ahead

Pick the date and time. Edit the message or the recipients, send it now, or delete it until it runs.

Both wallets

Apple Wallet shows your text as the lock-screen banner. Google Wallet sends its own notification and lists the message in the pass.

A report per campaign

Notified, skipped, failed, and the number of devices reached, plus a CSV with the outcome for every recipient.

The sender

The name and icon on the banner come from each pass, or you set one name and icon for every pass in the campaign.

Duplicate and archive

Send the same campaign to a new list with one click, and archive finished ones to keep the list short.

The same from the API

A PUT with a new notification does the same for one pass. Send a notification in the docs.

Frequently asked questions

Something else? Write to us from the chat in the dashboard, or at hello@walletwallet.dev.

Does it work on Android?

Yes. Google Wallet sends a notification of its own when the pass updates, and the message is listed in the pass. Apple Wallet shows your text as the banner on the lock screen.

What happens to a pass nobody added to a phone?

The message is written into the pass, so it is there the day the pass is added. There is no device to push to, so it does not count as reached.

Can I send to one segment?

Yes. Search by anything that is on the pass, such as a tier, a chapter, or a branch, and add every match. Or upload a list of serials from your own system.

What does a campaign cost?

One pass operation per pass that is updated, from the same monthly count as the rest of the API. Pro includes 100,000 a month. Passes that are skipped because they already show the message cost nothing.

How often can I send?

As often as you like. Apple shows every change on the lock screen, and Google Wallet delivers up to three notifications per pass in 24 hours, with later updates arriving without a banner. Sending the same text twice in a row skips the pass, so change the wording to send again.

Issue your first pass in five minutes.

Free under 1,000 passes a month. $39 flat above that, with a 7-day trial on every new account.