circle-exclamation
This documentation is currently under development. Certain sections are not yet complete and will be added shortly.

envelope-circle-userOffer

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

What are offers for?

Offers are designed to distribute promotional incentives to your customers in a simple, digital format. They help you 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’re a new client looking to create a template for the offer you’ll distribute to your customers, or a Wallet Crew expert wanting to update an existing template, this article will guide you step by step through our Template Designer. The goal is to configure an offer template that reflects your brand identity, displays the right information to your 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)
circle-info

If you want to go further, find all the details of the two versions:

Apple

Google

How to configure it on The Wallet Crew

With The Wallet Crew, you have access to a template designer that allows you to personalize the offer passes you will distribute to your clients. 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

On the general section, you have two mandatory field that you must fill :

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

  • Organization name : the name of your company or brand

You also have the possibility of putting a text next to your logo, activate the sharing of the ticket if you want your customers to be able to share it or not with other people, and the “void feature” for the coupons.

You can also define the distance from a relevant latitude and longitude that the offer pass is relevant, for geofencing notifications.

The Wallet Crew Offers - General Apple

Barcode

Choose the type of barcode that is compatible with your control hardware. The barcode value corresponds to the identifiers that will allow you to identify the offer 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

Colors & Images

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

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

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 you will choose is the same for every user (per language), but you can customize the value to display the expiry date for example.

The Wallet Crew Offers - Front fields Apple
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

Other sections

On Apple, you also have four other sections :

  • Locations : Used for geofencing notifications.

  • Beacons : Also used for geofencing notifications.

  • Associated store identifier : You can link your application if it's located on Apple Store

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

circle-exclamation
triangle-exclamation

Google

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

circle-exclamation
  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

On the general section, you have three mandatory fields that you must fill :

  • 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 your ticket (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

Barcode

Choose the type of barcode that is compatible with your control hardware. The barcode value corresponds to the identifiers that will allow you to identify the offer 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

Security

When you configure a template, you need to decide whether the customer can share their pass or not. Regarding Google you have three option:

  • 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

Colors & Images

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

The Wallet Crew Offers - Colors and images Google

You can decide to add additional links to the customer's offer, for exemple the event website link!

Furthermore, you can also configure the Smart tap feature that allows your customer to simply validate their offer by taping their device on your compatible hardware terminal.

Finally, the Valid time interval section allows you to define a start and an end date to your offer!

The Wallet Crew Offers - Smart tap Google

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

Value added opportunities

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

The Wallet Crew offers - Value added opportunities

Other sections

On Google, you also have 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

triangle-exclamation

FAQ

chevron-rightWhen should we use “Face Value” on an offer?hashtag

Use it when you want Google Wallet to display a monetary amount as part of the offer.

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

chevron-rightWhat happens if we set Locations?hashtag

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

Last updated