One benefit of app linking is that it empowers your call-to-action to navigate
users to your branded experiences from Google Wallet. Links with this feature appear at the bottom
of the Pass.
Feature example
Issuer
Set the app link on your Google Wallet pass
For a given gift card, set the field GiftCardObject.appLinkData
to the URI or Package name of your app or website.
See the format and context of the appLinkData field in the following source code:
The displayText field is limited to 30 characters.
[null,null,["Last updated 2025-09-03 UTC."],[[["\u003cp\u003eThere are four ways to add links to a gift card: using \u003ccode\u003eGiftCardClass.LinksModuleData\u003c/code\u003e for all cards in a class, \u003ccode\u003eGiftCardObject.LinksModuleData\u003c/code\u003e for a specific card, \u003ccode\u003eGiftCardObject.appLinkData\u003c/code\u003e for an app link at the bottom of a specific pass, and \u003ccode\u003eGiftCardClass.appLinkData\u003c/code\u003e for an app link at the bottom of all passes in a class.\u003c/p\u003e\n"],["\u003cp\u003eApp linking enables call-to-actions that navigate users to branded experiences from Google Wallet, appearing at the bottom of the pass.\u003c/p\u003e\n"],["\u003cp\u003eTo set an app link, configure the \u003ccode\u003eGiftCardObject.appLinkData\u003c/code\u003e field with the URI or Package name of your app or website for a given gift card.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eappLinkData\u003c/code\u003e field allows specifying \u003ccode\u003eandroidAppLinkInfo\u003c/code\u003e for Android and \u003ccode\u003ewebAppLinkInfo\u003c/code\u003e for web links, along with \u003ccode\u003edisplayText\u003c/code\u003e (limited to 30 characters) for the link's visible label.\u003c/p\u003e\n"],["\u003cp\u003eAn alternative implementation for \u003ccode\u003eappLinkData\u003c/code\u003e utilizes \u003ccode\u003etargetUri\u003c/code\u003e within \u003ccode\u003eandroidAppLinkInfo\u003c/code\u003e to link directly to the app's Play Store listing.\u003c/p\u003e\n"]]],["Links can be added to gift cards in four ways: via `GiftCardClass.LinksModuleData` (for all cards in a class), `GiftCardObject.LinksModuleData` (for a specific card), `GiftCardObject.appLinkData`, or `GiftCardClass.appLinkData` (both for app links). `AppLinkData` enables navigation to branded experiences and appears at the pass's bottom. Deep linking requires `webAppLinkInfo`. `appLinkData` includes `androidAppLinkInfo` or `webAppLinkInfo`, and `displayText` (limited to 30 characters).\n"],null,["# Add links to your Gift card\n\nThere are four ways to add links to a gift card.\n\n- Use `GiftCardClass.LinksModuleData` to add links to all gift cards that are associated with the `GiftCardClass`.\n- Use `GiftCardObject.LinksModuleData` to add a link to a specific gift card `GiftCardObject`.\n- Use [GiftCardObject.appLinkData](/wallet/retail/gift-cards/rest/v1/AppLinkData) to place an app link at the bottom of that particular Pass.\n- Use [GiftCardClass.appLinkData](/wallet/retail/gift-cards/rest/v1/AppLinkData) to place an app link at the bottom of all the passes of that class.\n\n\nOne benefit of *app linking* is that it empowers your call-to-action to navigate\nusers to your branded experiences from Google Wallet. Links with this feature appear at the bottom\nof the Pass.\n\n### Feature example\n\n|--------|\n| |\n| Issuer |\n\n### Set the app link on your Google Wallet pass\n\nFor a given gift card, set the field `GiftCardObject.appLinkData`\nto the URI or Package name of your app or website.\n\n\nSee the format and context of the `appLinkData` field in the following source code:\nThe `displayText` field is limited to 30 characters.\n**Note:** To deep link to a specific view within an app you must use webAppLinkInfo. \n\n```\n {\n \"id\": string,\n \"classId\": string,\n …\n …\n …\n \"appLinkData\": {\n \"androidAppLinkInfo\": {\n \"appTarget\": {\n \"packageName\": \"com.google.android.gm\",\n }\n },\n \"webAppLinkInfo\": {\n \"appTarget\": {\n \"targetUri\": {\n \"uri\": \"https://mail.google.com/mail/\",\n \"description\": \"Web link for Gmail\"\n }\n }\n }\n \"displayText\": {\n \"defaultValue\": {\n \"value\": \"Our awesome app!\"\n }\n }\n }\n }\n```\nFor posterity the following implementation will also work. \n\n```\n{\n \"id\": string,\n \"classId\": string,\n …\n …\n …\n \"appLinkData\": {\n \"androidAppLinkInfo\": {\n \"appTarget\": {\n \"targetUri\": {\n \"uri\": \"https://play.google.com/store/apps/details?id=com.google.android.gm\",\n \"description\": \"Play store link for Gmail app\"\n }\n }\n }\n }\n}\n```"]]