This documentation is currently under development. Certain sections are not yet complete and will be added shortly.
For the complete documentation index, see llms.txt. This page is also available as Markdown.
OfferPromotional incentiveCouponGift Card

Offer

Configure an Offer pass template for Apple Wallet and Google Wallet. Use it for time-bound coupons and discounts.

What are offers for?

Offers distribute promotional incentives to customers in a simple, digital format. They help brands drive traffic, boost conversions, and run time-limited campaigns directly within mobile wallets. An offer can be used to promote a discount, highlight a special event, reward specific customer segments, or support seasonal campaigns.

Whether you are a new client creating a template for the offers that will be distributed to customers, or already familiar with The Wallet Crew and updating an existing template, this article is a step-by-step tour of the Template Designer. The goal is to configure an offer template that reflects the brand identity, displays the right information to customers, and ensures a seamless experience across Apple Wallet and Google Wallet.

Use an Offer pass when the pass is a coupon. It is the best fit for one-time or time-bound discounts.

Common patterns:

  • A barcode or code redeemed at POS or in checkout

  • An expiration date and usage constraints

  • Campaign messaging pushed during the offer lifetime

If the pass represents stored value, use Gift card instead.

Architecture

Apple and Google have their own offer templates.

The Wallet Crew offer - Apple architecture
Offer template designer (Apple)
The Wallet Crew Offers - Google architecture
Offer template designer (Google)

To go further, find all the details of the two versions:

Apple

Google

How to configure it on The Wallet Crew

The Wallet Crew provides a template designer that is used to personalize the offer passes distributed to customers. Let’s see in detail how to personalize each section.

Apple

Let’s take a look at the different sections of the Apple template designer.

General section

The general section has two mandatory fields:

  • Description: a brief description of the pass, that will appear on the back of the card

  • Organization name: the name of the company or brand issuing the pass

It is also possible to put a text next to the logo, activate the sharing of the ticket so that customers can pass it on to other people, and the “void feature” for the coupons.

The section also defines the distance from a relevant latitude and longitude at which the offer pass is relevant, for geofencing notifications.

The Wallet Crew Offers - General Apple
Confirm that Description and Organization name are both filled in before saving.

Barcode

Choose the type of barcode that is compatible with the control hardware. The barcode value corresponds to the identifiers that allow the offer to be identified in store. Finally, the alternate text can be used to display the barcode data in case the barcode cannot be scanned.

The Wallet Crew Offers - Barcode Apple
Check that the barcode type matches what the redemption hardware accepts.

Colors & Images

To change the background color of the offer pass, simply add the color code in the fields provided for this purpose. To add an image, upload it from the device in use.

Header Fields

This section is particularly important in the Apple version, as the offers are stacked on top of each other. Only the header of the offer pass remains visible. Therefore, it is important that this section catches the eye and encourages clicking on the card, especially by displaying the most important information such as the amount left.

The Wallet Crew Offers - Header field Apple
Check that the header field carries the discount, since it is all that stays visible in a stack.

Front fields

The front fields are the fields that are used to display information in the recto of the offer, under the strip image. The label is the same for every user (per language), but the value can be customized to display the expiry date, for example.

The Wallet Crew Offers - Front fields Apple
Check that each front field has a static label and a dynamic value.
wand-magic-sparkles

Backfields

This section, located on the back of the offer pass, includes several useful pieces of information for the customer:

  • Expiry date

  • Information regarding the brand

  • Receipts

  • The ability to add links, such as a website link

The Wallet Crew Offers - Backfields Apple
Check that the offer conditions and the terms and conditions link are both present.

Other sections

On Apple, there are four other sections:

  • Locations: Used for geofencing notifications.

  • Beacons: Also used for geofencing notifications.

  • Associated store identifier: Used to link an application published on the Apple Store

  • NFC: A feature that allows customers to exchange digital content, and connect electronic devices with a touch.

Google

The Google template designer is a bit different than the Apple one.

  1. Some fields such as “Redemption Channel ” and “Provider” are mandatory

  2. Google preconfigures the fields based on their intended values

  3. Dynamic values (e.g., {{firstName}}) should be placed in dedicated dynamic fields. ‘Label’ fields are intended for static text only.

Let’s take a look at the different sections.

General section

The general section has five mandatory fields:

  • Issuer: the name of the brand or company that issues the offer

  • General: the title of the offer, such as "20% off any t-shirt."

  • State: the state of the offer (active, expired, completed, inactive)

  • Provider: the offer provider (either the aggregator name or merchant name).

  • Redemption channel: in store, online, both or unspecified

The Wallet Crew offers - General Google
Check that all five mandatory fields are completed, including Provider and Redemption channel.

Barcode

Choose the type of barcode that is compatible with the control hardware. The barcode value corresponds to the identifiers that allow the offer to be identified in store. Finally, the alternate text can be used to display the barcode data in case the barcode cannot be scanned.

The Wallet Crew Offers - Barcode Google
Check that the barcode value and its alternate text match the redemption code.

Security

Configuring a template means deciding whether the customer can share their pass or not. Google offers three options:

  • Multiple holders: it means that the customer can share their pass with anyone

  • One user all device: a customer but with several devices (a watch for example)

  • One user one device

The Wallet Crew Offers - Security Google
Check that the sharing option selected matches the campaign rules for the offer.

Colors & Images

To change the background color of the offer, simply add the color code in the fields provided for this purpose. To add an image, upload it from the device in use.

The Wallet Crew Offers - Colors and images Google
Check that the hero image and logo render correctly against the chosen background color.

Additional links can be added to the customer's offer, for example the event website link.

The Smart tap feature can also be configured, so that customers simply validate their offer by tapping their device on a compatible hardware terminal.

Finally, the Valid time interval section defines a start and an end date for the offer.

The Wallet Crew Offers - Smart tap Google
Check the Smart tap setting and the start and end dates of the offer validity window.

Messages

This section, located on the back of the offer pass, can include several useful pieces of information for the customer:

  • Expiry date

  • Information regarding the brand

  • Receipts

  • The ability to add links, such as a website link

The Wallet Crew Offers - Messages Google
Check that each message has a title and body, and that no placeholder text remains.

Value added opportunities

This section adds a small section at the bottom of the offer. This is used to display offers, or news.

The Wallet Crew offers - Value added opportunities
Check that the bottom section content is still current before a campaign goes live.

Other sections

On Google, there are four other sections:

  • Face Value: The price of the offer

  • App links: Used to add a link for an application

  • Homepage: Used to add the link of the event website

  • Locations: Used for geofencing notifications

FAQ

When should we use “Face Value” on an offer?

Use it when Google Wallet should display a monetary amount as part of the offer.

Keep it consistent with what the customer will see at checkout (currency, decimals, and wording in the offer title).

What happens if we set Locations?

Locations can help surface the pass when customers are near a specific place, and they can support location-based interactions.

Start with a small set of store locations first. Validate the experience on real devices before rolling out to all stores.

Next steps