> For the complete documentation index, see [llms.txt](https://docs.thewalletcrew.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thewalletcrew.io/guides-design/design/offer.md). # 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](/guides-design/design/gift-card.md) instead. ### Architecture Apple and Google have their own offer templates. {% tabs %} {% tab title="Apple" %}

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

{% endtab %} {% tab title="Google" %}

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

{% endtab %} {% endtabs %} {% hint style="info" %} **To go further, find all the details of the two versions:** {% endhint %} **Apple** {% embed url="" %} **Google** {% embed url="" %} ### 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.

{% hint style="warning" icon="wand-magic-sparkles" %} **To personalize the front fields, ask the tech team which dynamic value to write.** {% endhint %} ### 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. {% hint style="warning" %} **Please contact The Wallet Crew to activate these features** {% endhint %} {% hint style="danger" %} **Once the modifications are done, remember to click “save” at the top of the template designer!** {% endhint %} ## Google **The Google template designer is a bit different than the Apple one.** {% hint style="warning" %} **A few things worth knowing before configuring the Google template:** {% endhint %} 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.

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, Smart tap and Valid Time Interval **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 {% hint style="danger" %} **Once the modifications are done, remember to click “save” at the top of the template designer!** {% endhint %} #### 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).

Do App links require a mobile app?

Yes. App links are for taking customers into an Android app (or to a page the brand controls, depending on the setup). When there is no app, keep this section empty and use standard links in the pass instead.

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 * For design guidelines, start with [Card design](/configure/advanced-configuration/wallet/template-configuration/cards-design-colors-images-and-fields.md). * To distribute the pass, use [Add to Wallet on a website](/guides-enrolment/enrolment/on-your-website.md). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.thewalletcrew.io/guides-design/design/offer.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.