Setting up Google Wallet

For Google, Voyado recommends creating a separate Google Cloud project and a dedicated service account for the Wallet integration. The service account is only granted the permissions you explicitly assign to it, and does not automatically gain access to other resources in your Google environment or organization.

The only permission required is Wallet Object Issuer. By scoping permissions to what is strictly needed for Google Wallet, the integration can be fully isolated from your other systems.

Prerequisites

Before starting, make sure you have the following in place:

Configuration

You'll be doing the configuration in the Customer Engagement Config Hub. You'll find it in Customer Engagement at Administration > Config Hub > Marketing & Communications > Wallet.

Each setting in the configuration is dependant on the previous one.

1. Use Google's official documentation

Follow Google's official documentation for the setup. After you've gone through the two external articles listed here, you can go ahead and add the information in Config Hub.

  1. Setting up a Google Wallet API Issuer account
  2. Generating Google Wallet REST API authentication credentials

Two steps inside this documentation are easy to miss but will block your setup if skipped:

  • Enable the Google Wallet API for your project — do this by visiting https://console.developers.google.com/apis/api/walletobjects.googleapis.com/overview?project={PROJECTID}, where {PROJECTID} is your organisation's project ID.
  • Get publishing rights — all new accounts start in "demo mode," where passes can only be issued to Admin/Developer roles or test accounts. Follow the "Get publishing access" steps in the Google Wallet API Dashboard to lift this restriction.
Confirm both of these are done before moving on to step 2.

2. Add values to Config Hub

There are two values you'll need to add to Config Hub:

Issuer ID

Your Issuer ID identifies your business in Google Wallet and is required to issue passes.

Where to find it:

  1. Log in to the Google Pay & Wallet Console.
  2. Navigate to your account details.
  3. Copy your Issuer ID.

In Config Hub:

  1. Paste the Issuer ID into the Issuer ID field.
  2. Click Save.

Service account

A Google service account authorizes Voyado Customer Engagement to issue and update Wallet passes on your behalf.

How to set it up:

  1. In the Google Cloud Console, navigate to IAM & Admin > Service Accounts.
  2. Select an existing one that was created by the official Google documentation.
  3. Navigate to the service account's Keys tab.
  4. Click Add Key > Create new key and select JSON.
  5. Download the JSON key file.

In Config Hub:

  1. Click Edit under Service Account.
  2. Upload the JSON key file.
  3. Click Save.
Store your JSON key file securely. Anyone with this file can issue and update passes on your behalf.

Important points

Two important points about Google Wallet are:

Enable Google Wallet API

The organisation needs to have the Google Wallet API enabled. Enable it by visiting https://console.developers.google.com/apis/api/walletobjects.googleapis.com/overview?project={PROJECTID}, where {PROJECTID} is your organizations project ID.

Get publishing rights

All new accounts are created in 'demo mode'. In demo mode, you can create passes, but you won't have publishing access. This means the passes you create can only be issued to users who have the 'Admin' or 'Developer' role, or who have been added as a test account to your Issuer account. To enable publishing access, follow the steps under 'Get publishing access' in the Google Wallet API Dashboard.

Was this article helpful?

/