WalletWallet API

Digital loyalty cards for Apple and Google Wallet

Put every customer's points on a card in their phone, update it the moment they buy, and send reward nudges straight to the lock screen, with no app for them to install.

Apple Wallet Google Wallet

A whole loyalty program runs on $39 a month.

The self-serve alternative to PassKit, PassSlot, or PassEntry, with public pricing.

From a spreadsheet of customers to cards in their wallets.

  1. 1

    Design the card

    Set your brand color, logo, points field, and barcode in the visual editor, with a live preview and no code. The field reference has the full list.

  2. 2

    Get your customers on it

    Each customer's card is one POST /api/passes. Issue them whichever way fits:

    A developer runs a short loop

    Loop a script over your exported list, one POST per customer. See the create call.

    Add them one at a time

    Add customers by hand in the Pass Manager. Right for a counter signup sheet or a steady trickle.

    Issue on signup

    Connect your signup form or POS export through Zapier, n8n, or a plain HTTP request, and every new customer gets a card automatically.

  3. 3

    Deliver the links

    Every card gets a branded link that opens the right wallet for whoever taps it. Text it after the first purchase or print it as a QR by the register; it stays the same link through every points update.

  4. 4

    Scan at the till

    Put the customer ID in the barcode and pick the format your scanner already reads: QR, PDF417, Aztec, or Code128.

Run the whole program, not just the first visit.

Points, rewards, tier upgrades, and win-backs, each one update to the card the customer already carries, from the Pass Manager or your own system.

  1. Points land

    Add points with one update to the card the customer already holds, and notify their lock screen as soon as the new balance lands.

    The new points balance reaches the lock screen

  2. Reward unlocked

    When a customer crosses the reward threshold, put the reward on the existing card so staff can see it at the till without looking anything up.

    The same card, now carrying a free drink

  3. Tier upgrade

    Move a customer to a new tier with one update to the card already in their pocket. On Pro, each tier can carry its own color.

    The same card, moved to Gold

  4. Win-back

    Bring an inactive customer back with one update that puts a limited-time offer directly on their lock screen.

    A quiet card wakes up

  5. Revoke on close

    When an account closes, revoke the card once and it greys out across both wallets and every device, with the barcode removed.

    A closed account, greyed out everywhere

Loyalty card software that connects to what you already use.

The API is plain HTTP, so whatever runs your sales today can issue and update cards.

Export anytime

Pull your customer list out of the Pass Manager as a CSV. Each row carries the card's share URL, ready for a mail merge.

No plugins to maintain

Integration is one HTTP call, direct or through Zapier or n8n, so it runs beside Square, SumUp, Shopify, or Lightspeed with no plugin to keep updated.

The math for a real loyalty program.

Billing counts each create and each update that changes a card. One card covers both wallets and counts once, and a revoke is free. PassKit runs around $1,300/month for the same lifecycle.

A cafe with 400 regulars

WalletWallet
Cards issued at launch
400
Point updates per month
~8,000
Pro allowance
100,000/month
Total $39/month, flat

About 10 cents per regular a month, Pass Manager and full branding included.

Thank you

A 10-location chain, 12,000 members

WalletWallet
Creates and updates in a normal month
~90,000
Pro allowance
100,000/month
Busiest month at 150,000: overage
50,000 x $0.00039 = $19.50
Total $39 to $58.50/month

Flat $39 in a normal month; the worked overage covers the holiday rush.

Thank you

One pass covers both Apple and Google and counts once. Creations and content updates count, revokes do not. Full pricing.

Frequently asked questions

Do customers need to download an app?

No. Apple Wallet and Google Wallet are built into every iPhone and Android phone. A customer taps Add to Wallet on the card's page, or on the .pkpass you email them, and the card is in their wallet.

Can I set this up without a developer?

Yes. Design the card in the visual editor, then run the program from the Pass Manager: add a customer, add points, push a reward note, or revoke a card, all by clicking. The API is optional.

How do a customer's points or stamps update?

Every card has a serial number you get back when you create it. PUT the new balance to that serial and the card updates in place on every device it was added to, same link, no reissue. Set a changeMessage on the points field and the customer sees a note ("You are at 1,280 points").

Can the till scan the card?

Yes. Put the customer ID in barcodeValue and choose the format your scanner reads: QR, PDF417, Aztec, or Code128. The barcode renders in both wallets and scans like any plastic card.

Does this work on both Apple and Google Wallet?

Yes. One POST /api/passes returns the signed Apple .pkpass and a Save to Google Wallet link for the same card, and it counts as one pass. Updates and push work on both. Your custom update message shows on the Apple lock screen; Google's banner is generic and your text lives inside the card.

How do I run a stamp card, like buy nine get the tenth free?

A stamp card is a text field you increment, for example a STAMPS field set to 7 / 10. Update it on each visit and fire a changeMessage when it hits the goal. If the stamp card is your whole product, the punch cards page covers it in more depth.

What if a customer loses their phone?

The card lives on our servers, so the balance is not lost. Resend the same install link and the current card, with the latest points, adds to the replacement phone under the same customer ID.

What happens when a customer gets a new phone?

Passes usually transfer automatically when the new phone restores from an iCloud or Google backup. If one does not, or the customer switched platforms, resend the same install link and the current card adds in a tap.

Can a customer keep the card on two devices?

Yes. A customer can add the same card to more than one device, say an iPhone and an iPad, and every points update pushes to all of them.

Does the card show on an Apple Watch?

Yes. An Apple Wallet pass mirrors to a paired Apple Watch and updates with the phone, so a customer can scan at the till from their wrist. Keep the points balance in the front fields; the back and the strip image do not render on the Watch.

Can someone screenshot a card and share it?

Cards ship with the Apple Wallet share button hidden (sharingProhibited), so a customer cannot hand the live pass to a friend. A screenshot is still possible, but the barcode resolves to one customer ID, so a shared image reads as the same person earning twice at the till.

What does it cost to run a loyalty program?

Pro is $39 a month flat with 100,000 passes a month included (creations plus updates), then $0.00039 per pass beyond that. A cafe with 400 regulars pays about 10 cents per regular a month; a 10-location chain doing 150,000 creates and updates in its busiest month pays $58.50. One card covers both wallets and counts once, and revokes do not count.

Issue your first pass in five minutes.

Build a loyalty card and add it to your own phone tonight. Every new account starts with 30 days of Pro.

curl -X POST https://api.walletwallet.dev/api/passes …