Skip to content
PassMaker

Loyalty cards

How to create an Apple Wallet loyalty card

Build a loyalty or membership card for Apple Wallet with the right store-card fields, artwork, barcode, signing, and real-world test plan.

By Swapnanil Dhol8 min read

What you’ll leave with

  • Use a store card for loyalty, rewards, and gift-card programs; use generic for flexible membership credentials.
  • Put identity, tier, balance or points, and a scanner-compatible credential in a clear hierarchy.
  • Static custom passes do not gain live balance updates or contactless loyalty behavior automatically.

1. Decide what the loyalty pass represents

Define the job before designing the card. A loyalty pass may identify a member, display a tier or points balance, carry a redeemable code, or combine those roles. Choose the store card style for an ongoing retail relationship and a generic pass when the credential is a membership or access card without store-card behavior.

If you are copying a card issued by another business, check its terms and use the official Wallet option when available. If you operate the program, define the member identifier, reward rules, data owner, and update policy before issuing passes.

2. Plan the fields and scannable credential

Put the fact needed at checkout in the primary field: member name, current balance, points, or tier. Use secondary and auxiliary fields for the member number, expiry, next reward, or program status. Keep terms, support details, and privacy information on the back.

Ask the point-of-sale operator which barcode formats and payload rules it accepts. Reuse the exact recognized member identifier or a secure token generated by the loyalty backend. Add alt text so staff can perform a manual lookup when scanning fails.

  • Primary: points, balance, tier, or member identity
  • Secondary: member number, expiry, or next reward
  • Barcode: the identifier the point-of-sale system already recognizes
  • Back: terms, privacy, support, and program contact details

3. Build and sign the loyalty pass

In PassMaker, start with a store card or generic template, enter the identity and field values, configure the barcode, then add an icon, logo, and supported artwork. Use enough contrast for labels and values, and preview long names and large balances before export.

A Wallet pass must be packaged and signed before iPhone will install it. Export the Wallet-ready PKPass, add it to Wallet, and verify the displayed issuer, fields, artwork, and code. Keep the signing identity under the control of the organization responsible for the program.

4. Test redemption and plan for updates

Test the finished pass at the real checkout or access point. Confirm that scans resolve the correct account, manual lookup works, long values remain legible, and staff know what to do when a member is offline or the program backend is unavailable.

A static pass will keep the values embedded when it was created. Live balances, points, status changes, and remote revocation require a Wallet web service and push-update infrastructure. Contactless loyalty passes require a separate Apple approval, NFC certificate, and certified point-of-sale integration; a barcode pass does not become contactless by adding an NFC-looking icon.

Put it into practice

Build the JSON, then verify the package.

Use the free browser tools to turn the rules in this guide into a clean starting file and an actionable validation report.

Skip the hand-assembly.

PassMaker does every step on this page on your iPhone — field editor, artwork, manifest, PKCS#7 signing and Add to Wallet — without wiring up a signing environment.

Download on the App Store

Primary references