Skip to main content

Issuing Credentials

Issuing is done from a wallet with the issuer capability, using its configured Credential Issuer definitions (see Identity Templates). The wizard adapts itself depending on how that issuer definition is configured — you won't always see every step described below.

Starting an issuance​

Three entry points lead to the same wizard:

  1. Click an issuer tile in the Interactions panel on the wallet dashboard — starts a brand-new credential from scratch.
  2. Click the send icon on an existing Draft credential in the Issued Credentials list (Displaying Credentials) — resumes issuance for a credential that's already been drafted.
  3. Ask the Nexus Assistant to issue a credential for you — it opens the same wizard, pre-filled from the conversation, for your review and confirmation.

Step 1 — Authentic Source​

You fill in the credential's data — the form shown here depends on the credential type; most types use a generic data-entry form built from the type's Subject Definition, but some credential types have a specialized form plugin (for example, carbon footprint credentials use a dedicated calculator-style form).

After submitting, Nexus saves the entry as a Draft credential and shows a review screen — the same Credential Detail view described in Displaying Credentials — with Cancel and Next buttons, plus an inline Edit link if you need to go back and change something before continuing.

Some credential types are configured to always show this draft-review screen before letting the operator continue, so you get a chance to check the data even for a single-shot issuance.

Step 2 — Recipient​

Skipped automatically for self-issued credentials where the wallet already knows its own identifier. Otherwise, choose how to identify the holder using one of up to four tabs:

  • From Authentic Source — only shown if Step 1 already resolved a holder DID (e.g. the authentic-source form captured it). Just confirm and continue.
  • ID Token Exchange (default) — Nexus requests an ID token exchange and shows a QR code and a copyable URL with the caption "Share this URL with the holder to authenticate via ID Token." Share it however is convenient (in person, by chat, embedded in another app); Nexus polls in the background and advances automatically once the holder authenticates.
  • Manual DID — type the holder's DID directly, if you already know it.
  • WMP Entity — pick a wallet you already have a WMP connection with; no QR code needed since the offer will be pushed directly.

Step 3 — Authorization (conditional)​

Only appears if the credential issuer definition's Issuer Type requires it:

  • CredentialRequirements issuers show a form where you (the operator) fill in the values of the fields the issuer definition requires to be verified before issuance proceeds.
  • VPDriven issuers show a read-only summary of what the holder will be asked to present, with a Confirm button — the actual presentation request happens during the offer step.

IssuanceQueue issuers skip this step entirely.

Step 4 — Credential Offer​

What you see here depends on the issuer/recipient combination:

  • Self-issue mode — no QR code. The wallet automatically accepts its own offer; you'll see a "Issuing credential…" spinner followed directly by the success screen.
  • WMP mode — if you picked a WMP Entity in Step 2, the offer is pushed directly to the peer wallet instead of producing a URL; see Accepting Credentials for what the holder sees.
  • Standard mode — the offer URL is shown in a read-only, copyable field, alongside its expiry time and a QR code ("Scan to claim credential"). A spinner reads "Waiting for holder to accept…" while Nexus polls in the background; the screen advances automatically the moment the holder accepts.

Success​

A green check, "Credential Issued," the credential ID and holder, and a Done button to close the wizard.

If something goes wrong​

An inline error alert appears with a Retry action — you don't need to restart the whole wizard.

Resuming a draft​

Opening an existing draft credential (via the send icon in the Issued Credentials list) drops you straight into the draft-review screen from Step 1, then continues through Recipient/Authorization/Offer as normal. Choosing Edit instead restarts at Step 1 with your previous data pre-filled.

Continue to Verifying Credentials.