Overview
Credential Profiles are the foundation of the Issuer2 Service's profile-based architecture. A profile defines all the default values needed to issue a specific type of credential, making it easy to create consistent credential offers without repeating configuration.
What is a Credential Profile?
A credential profile is a reusable configuration that contains:
- Credential Configuration ID – The type of credential this profile issues (must match a credential configuration declared on your issuer service).
- Issuer Identity – The DID, key, and/or X.509 certificate chain used to sign credentials.
- Credential Data – Default data template for the credential.
- Data Mapping – Dynamic data functions for populating credential fields.
- ID Token Claims Mapping – Mapping from external IdP claims to credential data (for authorization code flow).
- mDoc Data Mapping – Type conversions for mDoc/mDL credentials.
- Authorized Transaction Data Types – OpenID4VP
transaction_datatypes an mDoc's device key may sign (embedded as MSOKeyAuthorizations). - Selective Disclosure – Which SD-JWT claims a holder can selectively disclose.
- Credential Status – Configuration for credential revocation/suspension.
- Notifications – Webhook settings for issuance events.
Profile Lifecycle
- Create – Define a profile with your desired configuration.
- Use – Create credential offers that reference the profile.
- Update – Modify the profile configuration (creates a new version).
- Delete – Permanently remove the profile when no longer needed.
Profiles support versioning. When you update a profile, a new version is created. Existing offers continue to use the profile version they were created with.
Deletion is permanent. Deleting a profile removes it entirely from the system — there is no soft-delete or INACTIVE state. Once deleted, a profile cannot be restored or referenced for new offers. Existing credential offers that were created from the profile are unaffected and continue to work until they expire.
Supported Credential Formats
Profiles can be created for any credential format your issuer service supports:
| Format | Description |
|---|---|
dc+sd-jwt | IETF SD-JWT Verifiable Credentials |
jwt_vc_json | W3C Verifiable Credentials (JWT) |
mso_mdoc | ISO 18013-5 Mobile Documents (mDL) |
Next Steps
- Create a Profile – Step-by-step guide to creating your first profile.
- Manage Profiles – View, update, and delete profiles.
