Display Configuration
The display configuration controls how your issuer service appears in wallet applications. This metadata is exposed via the OpenID4VCI discovery endpoints and helps users identify your organization when receiving credentials.
View Display Configuration
Retrieve the current display configuration for your issuer service.
Endpoint: GET /v2/{target}/issuer-service-api/configuration/openid-metadata/display/view | API Reference
Example Request
curl -X 'GET' \
'https://{orgID}.enterprise-sandbox.waltid.dev/v2/{target}/issuer-service-api/configuration/openid-metadata/display/view' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {yourToken}'
Example Response
[
{
"name": "walt.id Enterprise Issuer",
"locale": "en-US",
"logo": {
"uri": "https://cdn.walt.id/issuer/logo.png",
"alt_text": "walt.id logo"
}
}
]
Update Display Configuration
Update the display metadata for your issuer service.
Endpoint: PUT /v2/{target}/issuer-service-api/configuration/openid-metadata/display/update | API Reference
Example Request
curl -X 'PUT' \
'https://{orgID}.enterprise-sandbox.waltid.dev/v2/{target}/issuer-service-api/configuration/openid-metadata/display/update' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {yourToken}' \
-H 'Content-Type: application/json' \
-d '[
{
"name": "My Organization Issuer",
"locale": "en-US",
"logo": {
"uri": "https://example.com/logo.png",
"alt_text": "My Organization logo"
}
},
{
"name": "Mon Organisation Émetteur",
"locale": "fr-FR",
"logo": {
"uri": "https://example.com/logo.png",
"alt_text": "Logo de mon organisation"
}
}
]'
Body
[
{
"name": "My Organization Issuer",
"locale": "en-US",
"logo": {
"uri": "https://example.com/logo.png",
"alt_text": "My Organization logo"
}
},
{
"name": "Mon Organisation Émetteur",
"locale": "fr-FR",
"logo": {
"uri": "https://example.com/logo.png",
"alt_text": "Logo de mon organisation"
}
}
]
Display Configuration Properties
| Property | Type | Description |
|---|---|---|
name | String | Display name of the issuer |
locale | String | Language/locale code (e.g., en-US, de-DE, fr-FR) |
logo | Object | Logo configuration |
logo.uri | String | URL to the logo image |
logo.alt_text | String | Alternative text for the logo |
Delete Display Configuration
Remove the display configuration from your issuer service.
Endpoint: DELETE /v2/{target}/issuer-service-api/configuration/openid-metadata/display/delete | API Reference
Example Request
curl -X 'DELETE' \
'https://{orgID}.enterprise-sandbox.waltid.dev/v2/{target}/issuer-service-api/configuration/openid-metadata/display/delete' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {yourToken}'
Response Codes
200– Display configuration deleted successfully404– Display configuration not found
Multi-Language Support
The display configuration supports multiple locales, allowing wallets to show localized issuer information based on the user's language preference.
Example with Multiple Locales:
[
{
"name": "University of Technology",
"locale": "en-US",
"logo": {
"uri": "https://university.edu/logo.png",
"alt_text": "University logo"
}
},
{
"name": "Technische Universität",
"locale": "de-DE",
"logo": {
"uri": "https://university.edu/logo.png",
"alt_text": "Universitätslogo"
}
},
{
"name": "Université de Technologie",
"locale": "fr-FR",
"logo": {
"uri": "https://university.edu/logo.png",
"alt_text": "Logo de l'université"
}
}
]
OpenID Discovery
The display configuration is exposed via the OpenID4VCI credential issuer metadata endpoint:
GET /.well-known/openid-credential-issuer/v2/openid4vci
Wallets use this endpoint to discover issuer information and display it to users during credential issuance.