Get Support

Configuring Google Wallet

This guide walks you through setting up Google Wallet pass generation for your event tickets. You’ll need a Google Cloud account and access to the Google Pay & Wallet console.

Requirements

Before you begin, make sure you have:

  • A Google Cloud account
  • A Google Pay & Wallet Issuer account
  • Access to create service accounts in Google Cloud

Step 1: Enable the Google Wallet API

First, you need to enable the Google Wallet API in your Google Cloud project.

  1. Go to the Google Cloud Console at console.cloud.google.com
  2. Select an existing project or create a new one using the project dropdown at the top
  3. Navigate to APIs & Services → Library
  4. Search for Google Wallet API
  5. Click on the Google Wallet API result
  6. Click the Enable button

Wait for the API to be enabled before proceeding to the next step.

Step 2: Create a Service Account

A service account allows Voxel Events to communicate with Google Wallet on your behalf.

  1. In the Google Cloud Console, go to IAM & Admin → Service Accounts
  2. Click Create Service Account at the top
  3. Enter a Service account name (e.g., “Voxel Events Wallet”)
  4. The Service account ID will be auto-generated
  5. Enter an optional description (e.g., “Service account for event ticket passes”)
  6. Click Create and Continue
  7. Skip the optional “Grant this service account access” step by clicking Continue
  8. Skip the optional “Grant users access” step by clicking Done

Important: Note the service account’s email address (it looks like [email protected]). You’ll need this later.

Step 3: Generate the JSON Key File

Now create the credentials file that Voxel Events will use to authenticate.

  1. In the Service Accounts list, click on the service account you just created
  2. Click the Keys tab
  3. Click Add Key → Create new key
  4. Select JSON as the key type
  5. Click Create
  6. The JSON key file will automatically download to your computer

Important: This is the only copy of this key. Store it securely and never share it publicly. If you lose it, you’ll need to create a new key.

Step 4: Authorize the Service Account in Google Wallet Console

Grant your service account permission to create passes in your Google Wallet Issuer account.

  1. Go to the Google Pay & Wallet Console at pay.google.com/business/console
  2. Sign in with your Issuer account
  3. In the left navigation, click Users
  4. Click Invite a user
  5. Enter the email address of the service account you created (the one ending in @...iam.gserviceaccount.com)
  6. In the Access level dropdown, select Developer or Admin
  7. Click Invite

The service account now has permission to create and manage passes for your Issuer account.

Step 5: Get Your Issuer ID

You’ll need your Issuer ID to configure Voxel Events.

  1. In the Google Pay & Wallet Console, look at the top of the page or in your account settings
  2. Find your Issuer ID (a numeric value like 1234567890123456789)
  3. Copy this ID for the next step

Step 6: Configure Voxel Events

Now you can set up Google Wallet in Voxel Events.

  1. Go to Event Tickets → Settings in your WordPress dashboard
  2. Navigate to the Google Wallet section
  3. Upload your JSON key file (or paste its contents)
  4. Enter your Issuer ID
  5. Click Save

Important Notes

Access Levels

When inviting the service account:

  • Developer: Can create and manage passes (recommended for most use cases)
  • Admin: Full access including user management

Security Best Practices

  • Never share your JSON key file publicly
  • Don’t commit the JSON key to version control
  • Store a backup of the JSON key in a secure location
  • If the key is compromised, immediately delete it in Google Cloud and create a new one

Key Management

Unlike Apple certificates, Google service account keys don’t expire automatically. However, you should:

  • Rotate keys periodically for security (every 6-12 months)
  • Delete old keys after creating new ones
  • Monitor key usage in the Google Cloud Console

Troubleshooting

Pass generation fails with authentication error

Make sure:

  • The JSON key file is valid and complete
  • The Google Wallet API is enabled in your project
  • The service account has been invited to your Wallet Issuer account

Service account not appearing in Wallet Console

Verify:

  • You’re using the correct service account email (ends with @...iam.gserviceaccount.com)
  • You’re signed into the correct Google Wallet Issuer account
  • The invitation was sent successfully

API not enabled error

Go back to:

  • Google Cloud Console → APIs & Services → Library
  • Search for “Google Wallet API” and verify it shows as “Enabled”
  • Make sure you’re in the correct project (check the project selector at the top)

Issuer ID not found

If you can’t find your Issuer ID:

  • Make sure you have a Google Pay & Wallet Issuer account (not just a regular Google account)
  • You may need to apply for an Issuer account if you don’t have one
  • Check your account settings or contact Google support

Testing Your Setup

After completing the setup:

  1. Create a test event with tickets
  2. Purchase a ticket (you can use test mode if available)
  3. On the ticket confirmation page, click the Add to Google Wallet button
  4. Verify the pass appears correctly in Google Wallet on your device

If everything is configured correctly, the pass should be added to your Google Wallet with all the event details.

AI Assistant