Create an issuance

Before you start, make sure you have an active domain and brand. An issuance mapping is recommended.

Create the flow

1. In Ver.iD Studio, open Issue, then Issuances.
2. Click Create issuance.
3. Enter an internal name and click Create issuance.

The name helps you find the flow in Studio. It is not shown to the customer.

Add digital identity wallets and credentials

Digital identity wallets are currently labelled identity apps in Studio.

Open Attributes and click Add identity app. Select a digital identity wallet, then use its row actions to select the credentials and attributes you want to issue. Repeat this for every wallet you want to offer.

Add redirect URIs

Open Redirect URIs and click Add redirect URI. Select an active domain and enter the protocol, port, and callback path used by your application.

The redirect URI must exactly match the value sent in the OAuth request. Use HTTPS in production. To use the OAuth Debugging Tool, select test.ver.id. Studio automatically sets HTTPS, port 443, and /issuance/callback for this domain.

Add a brand and mapping

Open Brands, click Add brand, and select an active brand. If you add more than one brand, use the row actions to select the default.

Open Mappings, click Add mapping, and select an active issuance mapping when you want to send claim names instead of attribute UUIDs.

Add a client secret for production

1. Open Clients, then OAuth.
2. Click Create secret, enter a name, and create an OAuth secret.
3. Open the secret and copy its key to your server's secret store.
4. Return to the issuance, open Secrets, and add the secret.

Treat the key as a password. Do not include it in browser code, source control, logs, or documentation.

Optional settings

Use Settings to add the purpose, retention, sharing, deletion, and consent information shown during the flow.

Activate the flow

Click Activate. Activation may briefly show a provisioning state. When the issuance is active, Configuration shows its OAuth endpoints, client identifier, scope, and an issuance payload template.

An active flow cannot be edited. Click Deactivate before changing it.