eID Easy Docs

German EUDI Wallet

The German EUDI Wallet is Germany's national EUDI-compliant digital identity wallet. It lets users identify themselves with Person Identification Data (PID), store official digital credentials on their mobile device, and share only the data required for a specific request.

The integration follows the standard eID Easy OIDC flow. This page covers only what is specific to the German EUDI Wallet: prerequisites, the user-facing steps, the identity claims returned, and the current availability of the wallet.

Prerequisites

Before starting, ensure the following are in place:

  1. You have a working OIDC client set up on test.eideasy.comopen in new window with a registered redirect_uri.
  2. German EUDI Wallet is enabled for your client in the eID Easy admin panel.
  3. You have configured your JWK public key for private_key_jwt authentication. If not yet done, send us your client_id and your JWKs JSON or public JWKs URL so we can configure it for you.
  4. You have access to the German EUDI Wallet sandbox or another test environment that can provide a PID credential.

Testing in the playground

You can test this wallet through the eID Easy EUDI Wallet playground: http://eudiw-playground.eideasy.com/open in new window.

Running the flow

1. Start the authorization request

Follow Step 1 of the OIDC guide and include the pid scope to request verified identity claims:

scope=openid profile pid

2. Select the wallet on the authorization page

Once the eID Easy authorization page opens:

  1. Select Germany as the country
  2. Choose German EUDI Wallet as the method

3. Complete the wallet authentication

On the German EUDI Wallet screen:

  1. Scan the QR code with the wallet app, or open the wallet directly if you are using the same mobile device
  2. Review the PID attributes requested by the relying party
  3. Approve the data sharing request in the wallet, using the configured device unlock method such as a PIN, fingerprint, or facial recognition
  4. German EUDI Wallet app is installed and has a PID credential loaded on your test device. See Setting up the German EUDI Wallet below.

Once approved, the wallet redirects back to eID Easy, which redirects your user to your redirect_uri with an authorization code.

4. Exchange the code and validate the ID token

Follow Steps 3–5 of the OIDC guide to exchange the code and validate the returned ID token.

The ID token is a signed JWS. Verify it using the public key published via the discovery document:

https://test.eideasy.com/.well-known/jwks.json

Identity claims returned

When the user successfully authenticates with the German EUDI Wallet, the ID token includes a verified_claims object with government-issued identity data:

{
  "verified_claims": {
    "verification": {
      "trust_framework": "eidas",
      "time": "2026-03-11 12:29:34",
      "evidence": [
        {
          "type": "electronic_record",
          "document_details": {
            "type": "EudiPid"
          }
        }
      ]
    },
    "claims": {
      "given_name": "Erika",
      "family_name": "Mustermann",
      "birthdate": "1964-08-12",
      "nationalities": ["DE"],
      "birth_place": {
        "country": "DE",
        "locality": "Berlin"
      }
    }
  }
}
FieldDescription
verification.trust_frameworkAlways eidas for EUDI Wallet credentials
verification.timeTimestamp of when the verification was performed
verification.evidence[].typeelectronic_record for wallet-issued PID
verification.evidence[].document_details.typeEudiPid for EU Digital Identity PID credentials
claims.given_nameFirst name as on the official document
claims.family_nameLast name as on the official document
claims.birthdateDate of birth in YYYY-MM-DD format
claims.nationalitiesArray of ISO 3166-1 alpha-2 country codes
claims.birth_placeStructured birth location, where available

Current availability

The German EUDI Wallet is currently in development. According to the official German EUDI Wallet website, PID identification is being tested in a sandbox environment for different use cases, and the first version of the state wallet is planned for early 2027.

The official wallet is intended to be a free mobile app for people in Germany. It stores documents and credentials encrypted on the user's smartphone, without a central data repository, and supports data-minimizing disclosure so only the required attributes are shared.

For the latest status, see the official German EUDI Wallet app page: https://eudi-wallet.gov.de/en/appopen in new window.

Setting up the German EUDI Wallet

Currently, the iOS wallet app is not publicly available and is distributed by invitation only. You can request an invitation by emailing partner@eudi.sprind.org with the email addresses of the users you want to invite to the test app (via TestFlight).

Install Android wallet app

  1. Go to Google Playopen in new window
  2. Download the German EUDI Wallet app

Load a test PID credential

  1. Open app, on the welcome screen check "Use simulated eID card" and press "Get started"
  2. Press "Yes, eID card is available"
  3. Press "Yes, card PIN is set and known"
  4. Press "Agree by entering your card PIN"
  5. Enter any 6-digit PIN code (choose yourself) and press on the picture showing phone reading the card.
  6. Press "Set Wallet PIN" and choose and remember 6 digit PIN code. Repeat PIN once again and press "Set"

Your wallet is now loaded with a test PID credential and ready to use in the OIDC flow.

Last Updated: