Manage credential lifecycle

Once issued, credentials may need their status updated and their usage monitored. This page covers revocation through published status lists and monitoring issuance activity with analytics.

Manage credential lifecycle

Once issued, credentials may need their status updated. MATTR VII supports revocation through published status lists.

Revocation

• Configure revocation by enabling includeStatus in your credential configuration.
• MATTR VII publishes a status list that verifiers can retrieve.
• Control caching behavior with two parameters:
  • Time to Live (ttl): recommended duration for using a retrieved copy of the status list before fetching the latest version. Defaults to one day.
  • Expiry (exp): hard deadline after which a retrieved status list must not be used. Defaults to seven days.
• Wallets and verifiers can rely on cached statuses between ttl and exp to maintain offline usability. Setting appropriate values balances up-to-date status checking with user experience.
• Consider how to notify users if their credentials are revoked.

Monitoring with analytics

Track issuance activity using MATTR VII's Analytics API:

• Monitor issuance volume and success rates.
• Identify failures (timeout, claim source errors, authentication failures).
• Set up webhooks for real-time event streaming to your monitoring tools.

See the analytics setup guide for configuration.

Next steps

Review the frequently asked questions for answers to common issuance questions.