Google Wallet Setup Guide

Complete guide to configuring Google Wallet for PassLoop

📋 Prerequisites

✅ Good News! Google Wallet integration is completely free. No paid developer account required!

What You'll Need

🔧 Step-by-Step Setup

Step 1: Create Google Cloud Project

  1. Visit Google Cloud Console
  2. Sign in with your Google account
  3. Click Select a Project at the top
  4. Click New Project
  5. Enter project name: "PassLoop Wallet" (or your preference)
  6. Click Create
  7. Wait for the project to be created (takes a few seconds)
  8. Select your new project from the dropdown

Step 2: Enable Google Wallet API

  1. In Google Cloud Console, click the ☰ menu
  2. Navigate to APIs & Services → Library
  3. Search for "Google Wallet API"
  4. Click on Google Wallet API
  5. Click Enable
  6. Wait for the API to be enabled

Step 3: Create Service Account

  1. In Google Cloud Console, go to ☰ menu
  2. Navigate to IAM & Admin → Service Accounts
  3. Click Create Service Account
  4. Enter service account name: "passloop-service"
  5. Enter description: "PassLoop wallet pass generation"
  6. Click Create and Continue
  7. For role, select Owner (or create custom role with Wallet API access)
  8. Click Continue
  9. Click Done

Step 4: Generate Service Account Key

  1. Find your newly created service account in the list
  2. Click the ⋮ (three dots) menu
  3. Select Manage Keys
  4. Click Add Key → Create New Key
  5. Select JSON format
  6. Click Create
  7. A JSON file will download automatically
  8. Keep this file secure - it contains sensitive credentials

Step 5: Register with Google Pay & Wallet Console

  1. Visit Google Pay & Wallet Console
  2. Sign in with the same Google account
  3. Accept the Terms of Service
  4. Fill out your business information:
    • Business name
    • Business website
    • Support email
    • Support phone (optional)
  5. Click Submit for Review
  6. Approval is usually instant for testing, may take 1-2 days for production

Step 6: Get Your Issuer ID

  1. In Google Pay & Wallet Console, look at the URL
  2. Your Issuer ID is in the URL after /issuers/
  3. It's a long number, like: 1234567890123456789
  4. Copy this Issuer ID

Step 7: Upload to PassLoop

  1. Log in to your PassLoop account
  2. Go to Dashboard → Certificates tab
  3. Click Configure Google Wallet
  4. Upload your Service Account JSON file
  5. Enter your Issuer ID
  6. Enter your Application Name (optional, your business name)
  7. Click Save Configuration
✅ Success! You're now ready to generate Google Wallet passes.

🔧 Troubleshooting

Common Issues

"API not enabled"

Solution: Make sure you enabled the Google Wallet API in the correct project. Check that you selected the right project in Cloud Console.

"Invalid Issuer ID"

Solution: Double-check the Issuer ID from the Google Pay & Wallet Console URL. It should be a long number without any letters.

"Service account lacks permissions"

Solution: Ensure the service account has the "Owner" role or appropriate Wallet API permissions.

"Business not approved"

Solution: You can still test passes while under review. For production, wait for Google's approval (usually 1-2 business days).

"JSON file format error"

Solution: Make sure you downloaded the service account key in JSON format (not P12). Re-download if necessary.

Testing Your Configuration

  1. Create a simple test pass in PassLoop
  2. Click "Add to Google Wallet"
  3. If the Google Wallet page opens, your configuration is working!
  4. Complete the flow on your Android device to verify

Sandbox vs Production

While your business is under review:

Need Help?

Contact our support team at support@passloop.dev with:

📚 Additional Resources