1. Home
  2. Guides
  3. Getting Started
  4. Developers
  5. Set up Google Wallet certificates and publishing access

Set up Google Wallet certificates and publishing access

Set up Google Wallet credentials, upload them to your wallet project, and request publishing access for live passes.

View as Markdown

Google Wallet requires credentials that prove you can issue passes for your brand, plus publishing access from Google before live passes can reach users. Creating credentials is typically completed by a developer.

Important

Ensure your use case adheres to Google’s Acceptable Use Policies . Restrictions may cause delays or rejection. Contact your account manager or Airship Support if you are unsure about your wallet use case.

Get your Google Wallet credentials and authorize access

Google requires proof that your organization is authorized to issue passes. These steps establish that authorization in Google Cloud and the Pay & Wallet Console so Airship can create passes on your behalf.

Get your Issuer ID

Your Google Wallet API Issuer ID is necessary to create and distribute passes for Google Wallet. Get the ID:

  1. Go to the Google Pay & Wallet Console .
  2. Go to Google Wallet API in the console and select Build your first pass. After you accept the terms of service, your Issuer ID appears in the console.
  3. Save your Issuer ID somewhere you can access when completing configuration in the Airship dashboard.

Enable the Google Wallet API

Enable the Google Wallet API in the Google Cloud Platform:

  1. Log in to the Google Cloud Platform . If you do not already have a GCP project, create one.
  2. Enable the Google Wallet API  for your project.

Create a service account and certificate

Create a service account in Google Cloud and generate a .p12 certificate:

  1. Create a service account in the Google Cloud console  and enter an account name and ID.
  2. After entering the service account ID, save the service account email address. It is formatted similarly to airship-wallet-account@my-project-id.iam.gserviceaccount.com.
  3. Select Create and Continue, then Done.
  4. Select your new service account from the list.
  5. Go to Keys, or select the more menu icon () and Manage keys.
  6. Select Add Keys, then Create new key.
  7. Select P12 and select Create, and the p12 certificate file will download locally.

Authorize the service account

Grant the service account access to manage your Issuer Account so it can call the Google Wallet API:

  1. Log in to the Google Pay & Wallet Console .
  2. Go to Users and select Invite a user.
  3. Enter the service account email address from the Google Cloud console.
  4. Select the Developer access level.
  5. Select Invite.

Add a certificate to a wallet project

After you create a wallet project, use these steps to upload your certificate. That is usually a project you just created, but the same steps apply to any wallet project without a certificate.

Add a certificate:

  1. Go to Settings, then Certificates, and select Android.
  2. Enter the Issuer ID.
  3. Enter the service account email address from the Google Cloud console.
  4. Select Choose file and choose your .p12 file.
  5. Select Save.

Replace a certificate

Use this option when you need to upload a new certificate to your project, typically to replace an expiring certificate:

  1. Go to Settings, then Certificates, and select Android.
  2. Select Replace certificate.
  3. Enter the Issuer ID.
  4. Enter the service account email address from the Google Cloud console.
  5. Select Choose file and choose your .p12 file.
  6. Select Save.

Get publishing access

Before you can publish live Google Wallet passes, you must create a Google Wallet API class, complete your Google Wallet API business profile, and then get approval from Google.

First, create your first Google Wallet template in your wallet project. This will automatically generate your API class.

While you can manually create a class within the Google Pay & Wallet Console , creating your first Google Wallet template in the dashboard will generate a class for you and streamline the process.

Next, complete a Google Wallet API business profile:

  1. Go to the Google Pay & Wallet Console .
  2. Go to Google Wallet API in the sidebar.
  3. Select Complete business profile.
  4. Complete the Business identity and Business information sections of your business profile.

Google must approve your business profile before you can request publishing access. Once Google notifies you of approval, make your request:

  1. Go to the Google Pay & Wallet Console .
  2. Go to Google Wallet API in the sidebar.
  3. Select Request Publish Access and follow the prompts.