Skip to main content

Receiving Credentials

Some organisations — employers, universities, government agencies, and learning platforms — can issue verified credentials directly to your mwen.io wallet. These credentials are more trusted than your self-attested profile because they come from an independent issuer.

This page explains how to receive a credential when you are invited to do so.

How you get invited​

An organisation will share a credential offer with you in one of these ways:

  • QR code — displayed on a screen, in an email, or printed on a letter
  • Link in an email — tap it on your phone to open the offer in your wallet
  • Link on a web page — a "Claim your credential" button after completing a course or form

All of these lead to the same place: a credential offer that your wallet can read and accept.

Step 1 — Open the offer​

QR code: Open the mwen.io extension, tap the scan icon, and point your camera at the QR code.

Link on your phone: Tap the link. If mwen.io is installed, it opens automatically. If asked which app to open it with, choose mwen.io.

Link in a desktop browser: Click the link. The mwen.io browser extension intercepts it and opens the offer.

Step 2 — Review the offer preview​

Before you accept, your wallet shows you a preview of the credential you are about to receive. The preview includes:

  • The name of the organisation issuing the credential (e.g. "Acme Corporation" or "University of the West Indies")
  • The type of credential (e.g. "Employee Identity" or "University Diploma")
  • A trust badge showing how the issuer has been verified (see below)
  • The claims the credential will contain — for example, your name, employee ID, or course completion date

You are not sharing anything with the issuer at this point. You are only reading what you are being offered.

Step 3 — Accept or decline​

If the credential looks correct, tap Accept. The wallet:

  1. Proves to the issuer that you hold the wallet (using a cryptographic key binding proof — your identity phrase is not shared)
  2. Receives the signed credential from the issuer
  3. Stores it in your wallet

If something looks wrong — wrong name, wrong organisation, unexpected claims — tap Decline. Contact the organisation to request a corrected offer.

Trust badges on credential offers​

The trust badge on the offer preview tells you how the issuer has been verified in the mwen.io trust registry.

BadgeColourWhat it means
GovernmentBlueA government agency — the highest level of trust
Employer VerifiedGreenA verified employer or company
Accredited InstitutionGreenA verified university or academic institution
Verified PlatformGreenA verified online learning platform

An offer with no badge comes from an issuer not registered in the trust registry. You can still accept it, but the credential will not display a trust badge in your wallet.

After accepting​

Once accepted, the credential appears in the Profile tab of your wallet. You will see the trust badge next to the credential.

When you next sign in to an app that accepts verified credentials, your wallet will offer the issued credential instead of (or alongside) your self-attested profile. Apps that support higher trust levels will prefer the issued credential automatically.