Issuing passes for web, email, SMS

Once you've created a pass and encoded it in a signed JWT, you are ready to issue it anywhere that the 'Add to Google Wallet' link is supported. To do this, you will present your user with an 'Add to Google Wallet' button or a hyperlink, which will save the pass to their Google Wallet once they tap it. Examples of where you might use this method include websites, email, SMS, and more.

Prerequisites

Before you try to issue a pass, be sure you do the following:

Issuing a pass with an 'Google Wallet' link adds the Passes Object to a user's Google Wallet, and can only be initiated in the context of a logged-in Google identity.

The 'Add to Google Wallet' link is a dynamically generated URL that contains an encoded and signed JSON Web Token (JWT).

The Add to Google Wallet link has the following format:

https://pay.google.com/gp/v/save/<signed_jwt>

For example, a fully-formed 'Add to Google Wallet' link will look something like this:

https://pay.google.com/gp/v/save/eyJhbGci6IkpXVCJ9.eyJhdWQiO...6EkC1Ahp6A

This link can be embedded into websites, email, chat, SMS, or anywhere else that supports hyperlinks.

For more information on creating Passes Classes and Passes Objects, see Create Passes Classes and Passes Objects.

For more information on how to create the signed JWT needed to create an 'Add to Google Wallet' link, see Working with JSON Web Tokens.

2. (Recommended) Use the 'Add to Google Wallet' button

For any surfaces that support hyperlinking images, such as websites and email, it is recommended to present the 'Add to Google Wallet' link to your users with an 'Add to Google Wallet' button. For Google Wallet users, the button is a familiar prompt that is recognizable as a way to initiate adding a pass to their Google Wallet.

  • Add to Google Wallet button
  • Add to Google Wallet button condensed

Image assets are available to download in a variety of orientations and languages to support your Google Wallet API integration.

Download the 'Add to Google Wallet' button