Google Wallet API

This guide will walk you through the steps to obtain and set up the required certificate for integrating the Google Wallet API.

  • STEP 1. Set up a Google Cloud Project:

    -> Go to the Google Cloud Console.
    -> Create a new project or select an existing project.

    New Project

    -> Enable the Google Wallet API for your project.

enable API
  • STEP 2: Generate a Service Account file

To authenticate your requests to the Google Wallet REST API, you must create a service account and generate a service account key by following these steps:

  1. Go to IAM & Admin > Service Accounts. Navigate to the Create service account option in the top menu of the Google Cloud Console.
  2. Fill in the required details for the service account.
  3. Click the DONE button. You can skip the remaining steps for creating the service account.
  4. After creating the service account, click the three dots under the Actions column and select Manage Keys. Then, go to the KEYS tab.
  5. Open the ADD KEY drop-down menu and choose Create new key.
  6. In the dialog box, select JSON as the key type.
  7. Click CREATE to generate and download the service account key file.
  • STEP 3: Add the JSON Document to Wallet Configuration
    -> Save the JSON file securely in your project configuration under the Wallet section. Remember to select Enabled to upload the certificate and then save the configuration.
certificate

📘

Verify Integration

-> Test your integration by making a sample request to the Google Wallet API.
-> Ensure that your certificate is correctly applied, and your requests are authenticated.

Additional Notes
Certificates must be renewed periodically as they have an expiration date.
Keep your private key secure and avoid sharing it publicly.

Obtaining Publication Permissions for the Google Wallet API

Before you can manage Google Wallet passes, you must create a class and complete your business profile for the Google Wallet API. This is required to request publisher mode and obtain Google’s approval.

Having publisher mode is necessary to create pass issuers. Otherwise, you will encounter the following error when configuring Google in our wallet service: Unable to create Google Wallet issuer - Service account or user must already be shared with a non-suspended issuer.

Google Pay Wallet Console

Steps to Obtain Permissions:

  1. Access the Google Pay & Wallet Console
    Visit https://pay.google.com/business/console.
    If your Google account is not registered in the Google Wallet program, create an account.
  2. Add the Service Account Email
    Add the email address of the service account created in your Google Cloud project and grant it Developer permissions. Ensure this service account matches the credentials used to interact with the Google Wallet API.
  3. Start Building Passes
    Go to the Google Wallet API and click Build your first pass.
  4. Complete the Requirements
    Follow the requirements provided to request access for publication.
  5. Request Publisher Mode Access
    Once the requirements are met, you can submit a request for publisher mode access.
  6. Await Google’s Response
    After submitting your request, Google will send an email to notify you whether your application has been approved or denied.