Wallet pass Jinjava inserts

IMPORTANT: This feature is available in private preview mode and accessible only on selected workspaces. To get access, contact your account manager or Synerise Support.

This article contains wallet pass Jinjava inserts which you can use in all message channels available in Synerise.

walletPassId is the ID of the wallet pass. To find it, open the wallet pass for editing—the ID appears in the URL.

Optionally, set an expiration for the generated link itself with expirationTimeInDays (a number of days from now, as in the basic example) or expirationTime (an absolute date and time as an ISO 8601 date-time string, as in the variable example). This doesn't affect the expiration of the pass—that's configured separately when creating the wallet pass. If you don't set either parameter, the link doesn't expire.

You can also pass the following optional parameters:

  • eventParams - a JSON object with additional parameters to attach to the events generated for this link, for example eventParams={"campaign": "summer-sale"}. Use it to track things like the source of the click on the link. These parameters are added to the walletPass.issued, walletPass.installed, and walletPass.installFailed events. Values can be of any type.
  • platform - the platform to generate the link for: IOS or ANDROID, for example platform=IOS — if you don't set it, the visitor lands on a page that detects their device and shows a button to add the pass to their wallet, as shown below. If you set it, the visitor skips that landing page and goes straight to the native add-pass screen for the platform you specified.

Basic

{% walletpasslink walletPassId=983890bb-846a-448f-9fae-1a4c9e0d7997 expirationTimeInDays=7 %}

Variable

{% walletpasslinkvar walletPassId=983890bb-846a-448f-9fae-1a4c9e0d7997 expirationTime=2026-08-01T00:00:00+02:00 %}
    {{walletpasslink_result}}
 {% endwalletpasslinkvar%}

Result:
https://api.synerise.com/device-hub/wallets/issue?clientUuid=f6646ec5-34d4-4743-8c8f-3719443a8549&issueId=a2a77e3c-65bf-490d-8d97-39c3b4c3593c&hmac=DC2ZzhIzfvOI4SmWEMuAnIhax5t8KbdT4jXv2SYG3Xs

The generated link always includes the recipient's clientUuid, since it's rendered for the specific customer receiving the message - see Anonymous vs. identified links. Any dynamic field driven by profile data resolves to that customer's actual values.

The link directs to the following view:

Mobile browser page titled Get your pass, showing a message that the device was detected, with an Add to Google Wallet button and a note to use the other button if the automatic choice is wrong
The link automatically detects the visitor's device and offers the matching wallet button

Then:

Google Wallet Add card screen showing a promotional card from worldbox with the text 30% off clothing, and Cancel and Add buttons
The customer confirms adding the card on Google Wallet's native Add card screen

With optional parameters

You can combine eventParams and platform with either insert form, for example:

{% walletpasslink walletPassId=983890bb-846a-448f-9fae-1a4c9e0d7997 platform=IOS eventParams={"campaign": "summer-sale"} %}

When you set platform, the link skips the device-detection view shown above and directs the visitor straight to the native add-pass screen for the platform you specified.

Canonical URL: https://hub.synerise.com/docs/campaign/wallet-passes/wallet-passes-jinjava-inserts