Skip to main content

Create global configuration

POST 
/v2/config/digital-wallet/openid/global-configuration

Creates a global configuration for the OID4VCI issuer, including credential issuer metadata and default issuance parameters.

Request​

Body

    credentialExpirationInDays number

    Default expiration period (in days) for all credentials issued under this configuration. Individual credential definitions can override this value. Defaults to 30.

    credentialBranding objectrequired
    name string

    Default display name for credentials in wallet UIs, as specified in the OID4VCI Credential Issuer Metadata.

    description string

    Default human-readable description for credentials displayed in wallet UIs.

    backgroundColor string

    Default hex color code for the credential card background (e.g. #FFFFFF).

    textColor string

    Default hex color code for text on the credential card (e.g. #000000).

    credentialRequestEncryptionRequired boolean

    When true, the wallet must encrypt the OpenID for Verifiable Credentials Issuance (OID4VCI) Credential Request using the issuer's encryption key.

    authorizationRequestExpiry integer

    Time-to-live (in seconds) for the OID4VCI Authorization Request. After this period, the credential offer expires.

    credentialBindingMethods array

    Array of supported cryptographic key binding methods for issued credentials, as defined in OID4VCI Credential Issuer Metadata.

    credentialResponseInterval number

    Minimum polling interval (in seconds) for the wallet when using the OID4VCI Deferred Credential Endpoint.

Responses​

Response Headers
    Schema
      globalConfiguration object
      globalConfigurationId stringrequired

      Unique identifier for the issuer's global configuration.

      credentialExpirationInDays numberrequired

      Default expiration period (in days) for all credentials issued under this configuration. Individual credential definitions can override this value. Defaults to 30.

      credentialBranding objectrequired
      name string

      Default display name for credentials in wallet UIs, as specified in the OID4VCI Credential Issuer Metadata.

      description string

      Default human-readable description for credentials displayed in wallet UIs.

      backgroundColor string

      Default hex color code for the credential card background (e.g. #FFFFFF).

      textColor string

      Default hex color code for text on the credential card (e.g. #000000).

      logo object
      uri string

      URL of the default logo displayed on credential cards in wallet UIs.

      altText string

      Alt text for the logo image, used for accessibility.

      backgroundImage object
      uri string

      URL of the default background image for credential cards.

      altText string

      Alt text for the background image.

      credentialRequestEncryptionRequired boolean

      When true, the wallet must encrypt the OpenID for Verifiable Credentials Issuance (OID4VCI) Credential Request using the issuer's encryption key.

      authorizationRequestExpiry integer

      Time-to-live (in seconds) for the OID4VCI Authorization Request. After this period, the credential offer expires.

      credentialBindingMethods array

      Array of supported cryptographic key binding methods for issued credentials, as defined in OID4VCI Credential Issuer Metadata.

      credentialResponseInterval number

      Minimum polling interval (in seconds) for the wallet when using the OID4VCI Deferred Credential Endpoint.

      createdAt numberrequired

      Unix timestamp (in seconds) when this configuration was created.

      updatedAt numberrequired

      Unix timestamp (in seconds) when this configuration was last modified.

    Loading...
    Last updated on