Personalausweis
Verifies a user's identity using Personalausweis via AusweisApp
Provides a secure verification option where users prove their identity through Personalausweis via the AusweisApp. Ideal for fast, trusted onboarding or identity verification processes with strong eIDAS assurance.
info
For new integrations, use the eIDs (v2) step instead. It supports Personalausweis alongside other eID providers through a unified configuration, and is the recommended approach going forward. The GERMAN_EID:v1 step remains available for existing integrations.
Key features
- eID-based authentication: Secure authentication using Personalausweis via the AusweisApp middleware.
- Seamless redirection: Redirects users to AusweisApp for login and returns them post-authentication.
- Configurable shortname: Links to a pre-configured DocIDV journey on the platform.
Configuration
| Option | Type | Required | Default | Description |
|---|---|---|---|---|
config.live.shortname | string | Yes | - | DocIDV shortname for the live environment. Provided by IDnow during onboarding. |
config.staging.shortname | string | Yes | - | DocIDV shortname for the staging environment. Provided by IDnow during onboarding. |
inputSources | object | No | - | Maps upstream step IDs to input data blocks. See Input mapping. |
inputSources.basicIdentity | string | No | - | ID of an upstream step whose BasicIdentity output should be forwarded for cross-checking. |
enableRetry | boolean | No | false | When true, adds a retry output route that can be used to handle user cancellations. Defaults to false. |
Input data blocks
| Data block | Required | Description |
|---|---|---|
BasicIdentity | No | Identity data forwarded when inputSources.basicIdentity is configured. Used for cross-checking against the eID data. |
Routes
| Route | Description |
|---|---|
verified | The user's identity has been successfully authenticated by Personalausweis. Identity data was extracted from the eID chip. |
fraud_detected | Fraud was detected during the eID verification. No identity data is extracted — only the DocumentVerification data block is produced for audit purposes. |
retry | Available when enableRetry: true. User cancelled and can retry. |
Output data blocks
| Route | Data blocks produced |
|---|---|
| verified | BasicIdentity, ExtendedIdentity, DocumentData, DocumentVerification |
| fraud_detected | DocumentVerification |
| retry | DocumentVerification |