Configuring Talkable Wallet

Note

Talkable Wallet is enabled for your site by your Customer Success Manager. Reach out to them to add it to your account.

The pass is built in the campaign Editor with Liquid, the same template engine as the rest of the campaign, so you control its content, appearance, and behavior.

Customizing the pass

The pass is configured in the Editor. You can set the background, foreground, and label colors, the logo and other images, the barcode, the fields shown on the front and back of the pass, the sharing options, and the relevant and expiration dates. Every label on the pass is a setting you can edit in the Editor.

The pass settings are grouped on the Editor’s Copy, Images, Color, and Configuration tabs.

The pass is a Liquid template, so its content does not have to be the same for every customer. A field, an image, or a link can change with the customer’s segment, the custom data you pass to Talkable, or the state of their reward, so each customer’s pass shows their own values.

Installing and sharing the pass

Customers add the pass through the install link, which detects whether the customer is on iOS or Android and serves the matching Apple Wallet or Google Wallet pass. On a phone the customer taps the install button; on a desktop the page shows a QR code that the customer scans with their phone.

The install button and the QR code can be offered on the Advocate share page, the referral dashboard, the claim page, the reward emails, the Shopify post-purchase share page, and a standalone install page. Each place has its own setting in the Editor, so you choose where the pass is offered.

A Friend who reaches the claim page can install a pass of their own, once the claim page is set to offer it.

The barcode on the pass carries the Advocate’s referral link, so a Friend can scan it from the Advocate’s phone and claim the offer.

On Apple Wallet the customer can also share from the pass itself, using the phone’s own sharing options. Talkable shares the Advocate’s referral link together with a short message, and both are settings in the Editor.

Install links are also available over the API. Request an Offer or create an Origin with the wallet_platforms parameter, and the response returns an install link for each platform you ask for. When the campaign has no Google Wallet view, the Android link opens the Apple Wallet pass instead.

Featured Actions (iOS 27)

Featured Actions are up to two tappable tiles that Apple Wallet draws below the pass on the front screen. A customer who opens the pass, for example from a push notification, reaches the store, an offer, or the referral share page in one tap, without opening the back of the pass.

Featured Actions work on any Apple Wallet pass style and need iOS 27. Apple sets the label and the icon of each tile from the action type you choose, and you set the destination URL.

Each tile URL goes through Talkable’s link tracking. Talkable records each tap and attributes it to the Advocate who holds the pass. See Reporting.

To add them, open the campaign’s Apple Wallet view in the Editor. On the Configuration tab, enable Featured Action 1 and choose its action type, and do the same for Featured Action 2 if you want a second tile. On the Copy tab, set the URL each tile opens. The type and URL settings appear after the action is enabled and the view re-renders.

By default, the first action uses Shop Online or In-App and opens your site URL, and the second uses View Offers and Rewards and opens the Advocate’s share page.

Twelve action types are available, including Shop Online or In-App, View Offers and Rewards, Order Delivery or Pickup, Add to Balance, View Membership Benefits, and Book an Appointment. You choose the type on the Configuration tab; the full list with Apple’s labels is in Apple’s Wallet documentation.

Note

Featured Action tiles can be tailored per campaign. For tiles that are specific to a promotion, contact your Customer Success Manager.

Poster pass style

Poster Generic is an Apple Wallet pass style added in iOS 27. It shows full-bleed artwork across the front of the pass. Select it as the Apple wallet type on the Configuration tab.

Supply the poster artwork on the Images tab as PNG files in three sizes. The default artwork is 358 × 448 px, with 2x and 3x versions.

The poster face shows the customer’s fields and the barcode over the artwork, plus one footer line.

Older devices

One pass file carries both the poster layout and a classic layout, chosen with the Apple wallet fallback type setting. The default is a store card.

• On iOS 27 the pass shows the poster face with the Featured Action tiles.

• On iOS 26 and earlier the pass shows the classic face exactly as before, without the tiles. Links configured on the back of the pass remain available.

Featured Action URLs are configured separately from the links on the back of the pass. To make a custom action’s destination available on older devices, add the same URL to a back-of-pass link in the Editor.

The same pass serves both, so there is nothing to reinstall. The Editor previews the two faces side by side.

iOS 27 also adds four barcode formats used by retail and logistics scanners: Code 39, Codabar, EAN-13, and Interleaved 2 of 5 (ITF). When one of them is selected, the pass also carries a fallback barcode that older devices draw.

On Apple Watch, the tiles and the poster face need watchOS 27.

App Link

App Link adds a link to the pass that opens your own mobile app. If the customer does not have the app installed, the link sends them to the App Store or Google Play instead.

Apple Wallet

In the campaign’s Apple Wallet view, set apple_wallet_app_link_enabled to Yes on the Configuration tab. After the view re-renders, set your app’s App Store ID number on the Copy tab in the apple_wallet_associated_store_identifiers setting (you can list more than one, separated by commas), and optionally a launch URL in apple_wallet_app_launch_url. Apple shows the link on the pass and selects the first listed app that is compatible with the customer’s device. If the app is not installed, the link opens the App Store.

You can find the App Store ID in App Store Connect under your app’s App Information — it is the numeric Apple ID, the same number shown in your App Store URL (for example, https://apps.apple.com/app/id123456789).

Google Wallet

In the campaign’s Google Wallet view, set google_wallet_app_link_enabled to Yes on the Configuration tab. After the view re-renders, set google_wallet_app_link_android_package_name to your app’s package name and google_wallet_app_link_url_value to the fallback web URL on the Copy tab. If the customer has the app installed it opens; otherwise the web URL opens as a fallback. You can find the package name in the Google Play Console, or in your Google Play URL (for example, https://play.google.com/store/apps/details?id=com.example.myapp).