Leveraging Updated Pass Data with The Wallet Crew API

Update pass data through The Wallet Crew API, then display it in Apple Wallet and Google Wallet templates using Liquid.

Leverage updated pass data in templates

Passes are most valuable when they stay accurate over time. The usual pattern is simple: you update a pass through The Wallet Crew API, then your pass templates render the latest values using Liquid.

Real-world examples

• A loyalty pass shows points and tier and updates after each purchase.

• An event ticket shows the latest gate and seat after a schedule change.

• A membership card shows status and expiryDate after a renewal.

What “updated pass data” means

In The Wallet Crew, a pass can hold multiple data blocks (identifiers, metadata, additional data). These blocks are what you can update through the API, and what you can later render in templates.

If you are unsure where to store a field, start with Pass structure on The Wallet Crew.

Step-by-step: update data, then display it

1

1) Update the pass data through the API

Update the pass using the Pass API. This is the same API you use for push updates and data refresh.

Use the endpoint described in the Pass API reference (look for Update a pass).

If you are not creating passes yet, start with How to Create Passes via API in The Wallet Crew.

2

2) Inspect the updated data on a real pass

Open a pass and look at the JSON payload. This is your source of truth when you later reference fields in Liquid.

In the admin console, go to Wallet > Passes, pick a pass, then open the menu (...) and click View data.

Use “View data” to confirm the keys and values that exist on this pass.

3

3) Use Liquid in your pass template

Go to Wallet > Templates and edit the template used by your pass.

Edit the template that matches your pass type.

Then select the section you want to change. Sections are grouped so you can expand only what you need.

Pick the field where the updated value should appear.

When you need dynamic content (conditions, formatting, or computed strings), open the code editor (<>) and use Liquid.

Use Liquid when plain text fields are not enough.

Liquid syntax reference: Shopify Liquid documentation.

Avoid guessing variable paths. Use View data to confirm what exists on the pass, then reference those exact keys in your template.

4

4) Save and validate on a device

Save your template changes, then validate with a pass you can install on a phone.

If you distribute passes through a web page (including QR code flows), start with On your website. If you distribute from a native app, use On your mobile app.

Troubleshooting tips

If you don’t see the new value in Apple Wallet or Google Wallet, start by checking the pass payload in View data. If the value is missing there, the issue is in your update call. If it exists in View data but not on the rendered pass, the issue is in your template mapping or Liquid logic.

FAQ

What should I use: identifiers, metadata, or additional data?

Use identifiers to link the pass to external systems (CRM, ticketing, e-commerce). Use metadata to segment passes for operations (targeting, filters). Use additional data for extra values you want to persist and display (points, tier, store code, campaign flags).

If you want a quick overview, read Pass structure on The Wallet Crew.

Why does Liquid render empty values?

In most cases, the key does not exist on that specific pass. Confirm the field exists in View data, then make sure your template references the exact same key name.

Do I need to update the template after every data change?

No. Templates define how to display data. You typically update a template only when you change layout or add new fields. Day-to-day changes should be done by updating pass data through the API.