Format a Compact Credential as a Google digital Pass

This guide will show you how to format your Compact or Compact Semantic Credentials as a Google digital pass.


You need the following in order to proceed with this tutorial: 

  • Access to MATTR VII APIs. If you’re experiencing any difficulties, contact us.

  • The payload of a signed Compact or Compact Semantic Credential.

  • Google digital pass template: This is used by MATTR VII to format the different information from the credential into a digital pass.

Customers who choose to use their own certificates to manage these digital passes (Google/Apple) will need to ensure that these certificates do not expire. If you’re experiencing any difficulties, contact us


Make the following request to format a Compact Credential as a Google digital pass:

Copy to clipboard.
1POST https://YOUR_TENANT_URL/v2/credentials/compact/digitalpass/google

You can make a similar request to a different endpoint to format a Compact Semantic Credential as a Google digital pass:

Copy to clipboard.
1POST https://YOUR_TENANT_URL/v2/credentials/compact-semantic/digitalpass/google

Request body

Copy to clipboard.
2  "templateId": "1b04f0ee-8e3e-4153-a0e0-8603a10e7f0a",


Copy to clipboard.
2  "redirectTo": ""
  • redirectTo: This is the URL where the digital pass is available to download.

Bad request (400) Errors may occur in the following scenarios:

  • Payload is not a string.

  • Payload does not match a Compact Credential profile.

  • Unable to validate or decode the payload.

  • Google account credentials are missing or incorrect

  • The template does not exist or is incorrectly defined.

  • The decoded payload doesn't include a required field in template.json.

What's next?

Now that you have the Compact or Semantic Credential formatted as a Google pass, you you can share the download URL using your selected communication channel (e.g. e-mail, messaging platform, etc.). It can then be downloaded by the recipient, saved into a Google wallet and presented digitally to a verifier.