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.
Every endpoint below shares the same path parameters and authentication:
- orgID: String (required) - Your organization ID, e.g.
test.enterprise-sandbox.waltid.dev. - target: String (required) - The resource identifier of the issuer service,
{organizationID}.{tenantID}.{issuerServiceID}, e.g.waltid.tenant1.issuer1. - Authorization: String (required) - Bearer token. Format:
Bearer {token}.
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"
}
}
]
Response Codes
200— Display configuration returned.401— Invalid or missing authentication token.
Update Display Configuration
Replace the display metadata for your issuer service. The body is an array of display entries, one per locale.
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 Parameters
The body is a JSON array of display entries:
- name: String (optional) - Display name of the issuer.
- locale: String (optional) - Language/locale code (e.g.
en-US,de-DE,fr-FR). Each locale may appear only once. - logo: Object (optional) - Logo configuration.
- uri: String (required) - URL to the logo image.
- alt_text: String (optional) - Alternative text for the logo.
Example Response
[
{
"name": "My Organization Issuer",
"locale": "en-US",
"logo": {
"uri": "https://example.com/logo.png",
"alt_text": "My Organization logo"
}
}
]
Response Codes
200— Display configuration updated.400— Invalid request body (e.g. duplicate locales).401— Invalid or missing authentication token.
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}'
Example Response
An empty body with status 200.
Response Codes
200— Display configuration deleted successfully.401— Invalid or missing authentication token.
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. |
Multi-Language Support
The display configuration supports multiple locales, allowing wallets to show localized issuer information based on the user's language preference:
[
{
"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é" }
}
]
The display metadata is served as part of the issuer's OpenID4VCI credential issuer metadata, which wallets fetch to discover and display issuer information during credential issuance.