Format a Compact Credential as an Apple digital pass
This guide will show you how to format your Compact or Compact Semantic Credentials as an Apple 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.
Apple digital pass template: This is used by MATTR VII to format the different information from the credential into an Apple digital pass.
You must ensure your Apple developer certifications are valid when attempting to issue Apple digital passes. If you’re experiencing any difficulties, contact us.
Make the following request to format a Compact Credential as an Apple digital pass:
You can make a similar request to a different endpoint to format a Compact Semantic Credential as an Apple digital pass:
2 "templateId": "1b04f0ee-8e3e-4153-a0e0-8603a10e7f0a",
3 "payload": "CSC:/1/2KCE3IQEJB5DCMSMGZITM5QBE2QFSALWVQAXQI3ENFSDU53FMI5GYZLBOJXC45TJNEXGC5JQGEXG2YLUORZC4Z3MN5RGC3AFDJSZE7YQHIAACAACOFBW65LSONSSAQ3SMVSGK3TUNFQWYBA2NFLDPEDENZQW2ZLPIVWW2YJAJJQW4ZJAKRQXG3LBMRRW6ZDFMZEFGLRSG44HCY3FOJ2GSZTJMNQXI2LPNZHGC3LFOJLW64TLNFXGOIDBOQQEQZLJM5UHI43SMNSXE5DJMZUWGYLUNFXW4TDFOZSWYZ2MMV3GK3BAGRVGS43TOVSXETTBNVSXQGCBMR3GC3TDMVSCAU3BMZSXI6JAKRZGC2LONFXGOZTFPBYGS4TZNIZDAMRWFUYDCLJQGE5AAAIAACRAEAYDPB2WQ5DUOBZTULZPNRSWC4TOFZ3GS2JOMF2TAMJONVQXI5DSFZTWY33CMFWC6Y3POJSS65RSF5RXEZLEMVXHI2LBNRZS6Y3PNVYGCY3UF5ZGK5TPMNQXI2LPNYWWY2LTORZS6OBYG5RWIMJUGAWWKNDEG4WTINJRHAWWENZQMYWTGMBVMIZDGNZXHA4DIOAH3BAFA3FHFPDIRRKK4SM3ZDTKQSRCPRCYIA7RFUZYQI3RIGDHIGLAODJ6K2F245DTLIIKXAD35TORFQ7MVRJCIEPH6SC6NGA4HRMK76H5V6GXP66FFNX7MNYC6MYVU7ZLLXYVLXBU"
templateId: Use the
idof the Apple digital pass template you wish to use to format this credential.
payload: Use the
encodedelement from the response obtained when creating the Compact Credential.
The response includes a signed bundle .pkpass file (binary format).
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.
Apple developer account credentials are missing or incorrect.
The template does not exist or is incorrectly defined.
config.jsonfields are not defined.
The file name contains a special character that is not supported by the Apple pass template endpoint.
The decoded payload is missing a required value for
Now that you have the Compact or Semantic Credential formatted as an Apple pass, you can share the
.pkpass file using your selected communication channel (e.g. e-mail, messaging platform, etc.). It can then be downloaded by the recipient, saved into an Apple wallet and presented digitally to a verifier.