Overview

Your advocates and friends can add a reward as a pass in their mobile wallets. They do this from their earned reward emails. Turn on Mobile Wallet Button and set your Mobile Wallet Button Text in the Overview tab. Advocates can also keep their share link in their mobile wallet as a QR code. See Share Link Passes below. Every pass is signed with Extole’s own Apple Wallet certificate, so you don’t need an Apple developer account or a certificate of your own.

Example earned reward email for a sample brand, with the Add to Mobile Wallet button under the coupon code.

This feature has 3 distinct pieces:

An iOS native mobile wallet pass, compatible with iOS devices
An iOS-issued mobile wallet pass, compatible with Android devices using the WalletPasses app
A desktop landing page prompting users to open their pass on their mobile device by scanning a QR code

Google Wallet is not supported. This article walks through the creative elements required to use reward passes. An advocate can save their share link to Apple Wallet as a pass. The pass shows the share link as a QR code, so the advocate can open their wallet and let a friend scan it in person. Share link passes work the same way as reward passes:

On desktop, the wallet page opens in a new tab and shows a QR code. The advocate scans it with their phone’s camera, and their phone prompts them to add the pass to their wallet.
On mobile, the wallet page opens and prompts the advocate to add the pass to their wallet directly.
On Android, the pass is the same iOS-issued pass, opened with the WalletPasses app.

Example wallet page on desktop, for a sample brand. The advocate scans the QR code with their phone to add the pass.

Example share link pass for a sample brand: the phone asks to add the pass, then the pass sits in Apple Wallet with the share link as a QR code.

Share link passes are signed with the same Extole certificate as reward passes, so they need no extra setup with Apple. Contact your CS team to add a share link pass to your program.

Overview Variables

Example reward pass for a sample brand. The front shows the pass logo, pass strip, name and coupon code. The back shows the terms and the updates.

Creative Variable Name	Uses
Company Logo Image	Shows in the upper left-hand corner of the microsite (see below) to reinforce your brand. Also typically used as the Pass Logo.
WalletPasses Button	Prompts users to download their pass to their mobile Android device using the WalletPasses app. This is visible on the mobile reward pass destination.
Pass Logo	Typically the same as the Company Logo; shows in the upper left-hand corner of the pass.
Pass Strip	Can call out what the pass can be used for. In our example, it’s the image that says “Take 20% off your next purchase!”.
Label for Name on Pass	Typically left as “Name”; signifies who the pass belongs to.
Label for Coupon Code on Pass	Typically left as “Coupon Code”; calls out the coupon code associated with the reward.
Label for Terms on Pass	On the back of the pass, how the Terms and Conditions should be referred to. Typically left as “Terms and Conditions”.
Label for Updates on Pass	On the back of the pass, how the Updates section should be referred to. Typically left as “Updates”.
Text for Updates on Pass	Any updates you’d like to call out on the back of the pass.
Pass Barcode Type	Valid Values: QR, PDF_417, AZTEC, CODE_128
Text for ‘Back’ Button on Back of Pass	On the back of the pass, what the user clicks on to return to the front of the pass. Typically left as “Back”.
Wallet Pass Font Family	What font family the pass fonts belong to.

Reward.pkpass

Creative Variable Name	Uses
Reward Pass Description	A description for the pass; usually left as the Company Name.
Reward Pass Organization Name	The name of the organization issuing the pass (that’s you!).
Icon Image URL	The URL where the icon image is hosted. This defaults to your company icon, as set in the Overview tab.
Logo Image URL	The URL where the logo image is hosted. This defaults to your company logo, as set in the Overview tab.
Strip Image URL	The URL where the strip image is hosted. This defaults to the Pass Strip, as set in the Overview tab.
Background Color RGB	The background color of the pass. Use Syntax: redValue,greenValue,blueValue e.g. 255,255,255
Foreground Color RGB	The foreground color of the pass. Use Syntax: redValue,greenValue,blueValue e.g. 255,255,255
Label Color RGB	The color for the text labels on the pass.
Barcode Type	Valid Values: QR, PDF_417, AZTEC, CODE_128
Label for Coupon Code on Pass	Typically left as “Online Code”; calls out the coupon code associated with the reward.
Label for Name on Pass	Typically left as “Name”; signifies who the pass belongs to.
Label for Terms on Pass	On the back of the pass, how the Terms and Conditions should be referred to. Typically left as “Terms and Conditions”.
Terms Text	The terms and conditions of using the pass.
Pass Updates Label	On the back of the pass, how the Updates section should be referred to. Typically left as “Updates”.
Back Field Change Message	This is the text value for the alert that is displayed when the value associated with the Updates field is updated. The change value text must contain the escape value %@, which is replaced with the field’s new value.

Desktop Landing Page

Example desktop landing page for a reward pass, for a sample brand.

Creative Variable Name	Uses
Microsite Banner Image for Desktop	Shows as the image at the top of the microsite on desktop. Recommended image size 2800 x 800 px in .png or .jpg format.
Microsite Banner Image for Mobile	Shows as the image at the top of the microsite on mobile. Recommended image size 1080 x 900 px in .png or .jpg format.
Prompt to Scan QR Code	Something like “To add to your mobile wallet, scan this QR Code”.
Prompt to Print Pass	Something like “Print my pass”.
Background Image Headline Copy	Something like “Your reward is here!”.
Heading Text	Something like “You earned it”.
Coupon Code Copy Instruction	Something like “To redeem online, copy your code and enter it at checkout”.
Terms Text	The terms and conditions that show on the preview of the pass.

Platform Overview

Programs & Campaigns

Audiences & Segmentation

Rewards Management

Strategy & Best Practices

Notifications & Troubleshooting

Compliance & Policies

User Management

Using Reward and Share Link Passes with a Mobile Wallet

Overview

Overview Variables

Reward.pkpass

Desktop Landing Page

​Overview

​Share Link Passes

​Overview Variables

​Reward.pkpass

​Desktop Landing Page

Overview

Share Link Passes

Overview Variables

Reward.pkpass

Desktop Landing Page