Gift card
Configure a Gift card pass template for Apple Wallet and Google Wallet. Show stored value, support barcode/NFC redemption, and keep balance up to date.
Whether you’re a new client looking to create the template for the gift cards you’ll distribute to your customers, or a Wallet Crew expert looking to update an existing template, this article will guide you through our template designer. The goal is to configure a gift card 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 a Gift card pass when the pass represents stored value. This template is designed for balance display and balance updates.
Typical patterns:
Initial balance at issuance
Partial redemptions that decrease the balance
Top-ups and refunds that update the same pass
If your pass is a discount coupon (not stored value), use Offers instead.
Architecture
Apple and Google have their own gift card pass templates as you can see below.
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 gift cards 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 gift card, 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 gift card if you want your customers to be able to share it or not with other people, the “void feature” for the coupons, a relevant and expiration date that are used for event tickets.
You can also define the distance from a relevant latitude and longitude that the pass is relevant, for geofencing notifications.
Barcode
Choose the type of barcode that is compatible with your point-of-sale software. The barcode value corresponds to the identifiers that will allow you to identify the card with your terminal in the store. Finally, the alternate text can be used to display the barcode data in case the barcode cannot be scanned.
Colors & Images
To change the background color of your card, 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 cards are stacked on top of each other. Only the header of the card 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 available.
Front fields
The front fields are the fields that are used to display information in the recto of the card, 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 for example the expiry date of the card.
To personalize the front fields please refer to your tech team to find which dynamic value you have to write.
Backfields
This section, located on the back of the loyalty card, includes several useful pieces of information for the customer:
The expiry date of the gift card
The amount
Receipts
Personalized messages
Links, such as the terms and conditions, etc.
Other sections
On Apple, you also have three 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.
Please contact your The Wallet Crew representative to activate these features
Once you’ve done some modifications, don’t forget to click on “save” on the top of your screen!
Google
The Google template designer is a bit different than the Apple one.
Here are a few things you need to know before configuring your Google template:
Some fields such as issuer and program name are mandatory
Google preconfigures fields based on their intended values, so keep the balance in the dedicated balance/value fields
Dynamic values (e.g., {{balance}}) 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 pass
Program name: it appears on the front of the pass, it can be the name of your loyalty program for example
Card number: the number of the gift card
Barcode
Choose the type of barcode that is compatible with your point-of-sale software. The barcode value corresponds to the identifiers that will allow you to identify the card with your terminal in the store. Finally, the alternate text can be used to display the barcode data in case the barcode cannot be scanned.
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
Colors & Images
To change the background color of your card, simply add the color code in the fields provided for this purpose. To add an image, upload it from your device.
Balance and Pin
In this section, you have to enter the dynamic value for the amount of the gift card and the currency as they are mandatory fields. You can also configure a Pin label and Pin if needed.
Additional links, Smart tap and Valid Time Interval
You can decide to add additional links to the customer's gift card, for exemple your website link!
Furthermore, you can also configure the Smart tap feature that allows your customer to simply validate their gift card by taping their device on your compatible terminal.
Finally, the Valid time interval section allows you to define when a gift card can be used!
Messages
This section, located on the back of the gift card, includes several useful pieces of information for the customer:
The expiry date of the gift card
The amount
Receipts
Personalized messages
Links, such as the terms and conditions, etc.
Value added opportunities
This section allows you to add a small section at the bottom of the gift card. This is used to display offers, or news.
Other sections
On Google, you also have four other sections :
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
Once you’ve done some modifications, don’t forget to click on “save” on the top of your screen!
Next steps
For design guidelines, start with Card design.
To distribute the pass, use Distribution (SDK).
Last updated