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.
Prerequisites
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.
Request
Make the following request to format a Compact Credential as a Google digital pass:
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:
1POST https://YOUR_TENANT_URL/v2/credentials/compact-semantic/digitalpass/google
Request body
1{
2 "templateId": "1b04f0ee-8e3e-4153-a0e0-8603a10e7f0a",
3 "payload": "CSC:/1/2KCE3IQEJB5DCMSMGZITM5QBE2QFSALWVQAXQI3ENFSDU53FMI5GYZLBOJXC45TJNEXGC5JQGEXG2YLUORZC4Z3MN5RGC3AFDJSZE7YQHIAACAACOFBW65LSONSSAQ3SMVSGK3TUNFQWYBA2NFLDPEDENZQW2ZLPIVWW2YJAJJQW4ZJAKRQXG3LBMRRW6ZDFMZEFGLRSG44HCY3FOJ2GSZTJMNQXI2LPNZHGC3LFOJLW64TLNFXGOIDBOQQEQZLJM5UHI43SMNSXE5DJMZUWGYLUNFXW4TDFOZSWYZ2MMV3GK3BAGRVGS43TOVSXETTBNVSXQGCBMR3GC3TDMVSCAU3BMZSXI6JAKRZGC2LONFXGOZTFPBYGS4TZNIZDAMRWFUYDCLJQGE5AAAIAACRAEAYDPB2WQ5DUOBZTULZPNRSWC4TOFZ3GS2JOMF2TAMJONVQXI5DSFZTWY33CMFWC6Y3POJSS65RSF5RXEZLEMVXHI2LBNRZS6Y3PNVYGCY3UF5ZGK5TPMNQXI2LPNYWWY2LTORZS6OBYG5RWIMJUGAWWKNDEG4WTINJRHAWWENZQMYWTGMBVMIZDGNZXHA4DIOAH3BAFA3FHFPDIRRKK4SM3ZDTKQSRCPRCYIA7RFUZYQI3RIGDHIGLAODJ6K2F245DTLIIKXAD35TORFQ7MVRJCIEPH6SC6NGA4HRMK76H5V6GXP66FFNX7MNYC6MYVU7ZLLXYVLXBU"
4}
templateId
: Use theid
of the Google digital pass template you wish to use to format this credential.payload
: Use theencoded
element from the response obtained when creating the Compact Credential.
Response
1{
2 "redirectTo": "https://pay.google.com/gp/v/save/ejqEeFUtiFRF2t_0hXelmd1TDaeoPES091NT7LBiDvrmKpYPrOlhBfeSKOaA"
3}
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.