Overview

Google Wallet API already lets you engage with users through various predefined types of passes (loyalty card, offer, gift card, event ticket, transit ticket, boarding pass) which come with use-case specific fields and features.

Our existing pass types might not fit every use case, and that is why the generic pass type was created. As the name suggests, generic pass type should be used when your use case does not fit into any of our other specialized types. To understand how the Generic Pass can support your specific use case, visualize your pass in real time.

Use cases

Below are a few example use cases that fit the model for the Generic Vertical:

  • parking passes
  • library membership cards
  • stored value vouchers
  • gym membership cards
  • driver insurance cards
  • reservations of various kinds
  • country border crossing QR codes
  • customer pre-screen confirmation codes

Use cases involving sensitive information

There are cases where your pass or use case may involve sensitive information (see the AUP for a definition of sensitive data). For these scenarios the Generic Private Pass API provides a way to define a Private Pass for pre-approved use cases. An overview of the Generic Private Pass API and the covered use cases can be found on the Generic Private Pass developer site.

Integration steps

The following steps are required to integrate with the Google Wallet API. Select your integration type below depending on if you are reaching your customers on Android devices only or on Android, Web, Email, or SMS.

Android, Web, Email, or SMS

  1. Understand how classes and objects work & familiarize yourself with the Add to Google Wallet flows
  2. Complete the prerequisites
  3. [Optional] Build a pass using the pass visualizer tool to generate the JSON for your classes and objects
  4. Create a JWT link with the class and object signed with your private key
  5. Surface the Add to Google Google Wallet button in your application
  6. Complete the testing checklist
  7. Request for publishing access in the Google Pay and Wallet Console

Android Only

  1. Understand how classes and objects work & familiarize yourself with the Add to Google Wallet flows
  2. Complete the prerequisites
  3. [Optional] Build a pass using the pass visualizer tool to generate the JSON for your classes and objects
  4. Create a pass by saving a signed JWT or by saving unsigned JSON using the Android SDK
  5. Surface the Add to Google Google Wallet button in your application
  6. Complete the testing checklist
  7. Request for publishing access in the Google Pay and Wallet Console

Get started

To be guided through these steps, get started with our hands on Codelab for Web and Android, or start by choosing the right integration for you. The right integration for you depends on your specific requirements and is mostly driven by how you wish to reach your customers.