> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Ausweisverifizierungsmethoden in der Console einrichten

> In Didit pro Land festlegen, welche der 3 Ausweisverifizierungsmethoden gelten, Fallback-Schalter setzen und die genutzte Methode je Sitzung lesen.

Der Schritt [Ausweisverifizierung](https://docs.didit.me/de/core-technology/id-verification/verification-methods.md) in einem Workflow hat einen Reiter **Länder**. Dort legen Sie Land für Land fest, welche der drei Methoden eine Person verwenden darf und was passiert, wenn eine Methode ohne Dokument kein Ergebnis liefert. Alles auf dem Reiter schreibt den Schlüssel [`methods`](https://docs.didit.me/de/management-api/workflows/feature-configs#ocr-/-ausweisverifizierung) am Knoten Ausweisverifizierung. Konsole und Management API sind zwei Ansichten desselben Objekts.

## Länder und zulässige ID-Methoden

Öffnen Sie einen Workflow, wählen Sie den Knoten **Ausweisverifizierung** und dann **Länder**. Jede Länderzeile zeigt die Methoden, die für dieses Land akzeptiert werden. Wählen Sie ein Land, um dessen Editor zu öffnen.

| Abschnitt | Was er steuert | Geschriebene Konfiguration |
| - | - | - |
| **Dokumentaufnahme** | Ob ein fotografiertes Dokument akzeptiert wird, außerdem die Dokumenttypen, Untertypen und Aufnahmeregeln für dieses Land | `document.enabled`, `documents_allowed` |
| **Abfrage ohne Dokument** | Ob die Abfrage ohne Dokument angeboten wird, wie viele beantwortete Versuche der Benutzer erhält und ob die späteren Schritte Liveness-Erkennung und Gesichtsabgleich des Workflows nach einem porträtgestützten Treffer übersprungen werden | `id_lookup.enabled`, `id_lookup.max_attempts`, `id_lookup.skip_liveness_and_face_match` |
| **Akzeptierte Wallets** | Welche digitalen Ausweis-Wallets dieses Land anbietet. Eine Zulassungsliste, keine Rangfolge: Der Endbenutzer wählt aus dem, was Sie angekreuzt haben | `wallet.enabled`, `wallet.providers` |
| **Bei folgendem Fehler zur Dokumentaufnahme zurückfallen …** | Ein Schalter pro Fehlerfall | `id_lookup.on_partial_match`, `id_lookup.on_no_match`, `id_lookup.on_provider_error`, `wallet.on_failure` |

Die Schalter **Bei folgendem Fehler zur Dokumentaufnahme zurückfallen …** sind immer aus, wenn das Land keine Dokumentaufnahme hat, weil es dann nichts gibt, worauf zurückgefallen werden könnte. Aktivieren Sie zuerst **Dokumentaufnahme** für das Land, um sie zu nutzen.

Ein Land, in dem Sie alle Methoden deaktivieren, wird beim Speichern mit **Keine Methode aktiviert – hier kann sich niemand verifizieren** abgelehnt, weil diese Konfiguration niemanden verifizieren kann.

### Dokumentaufnahme nur als Ausweichlösung anbieten

Öffnen Sie ein Land und wählen Sie **So verifizieren sich Nutzer hier**:

| Auswahl | Was Benutzer sehen |
| - | - |
| **Wallet zuerst, bei Fehler Dokument** | Nur die Wallet (oder die Abfrage ohne Dokument, wenn keine Wallet ausgewählt ist). Die Dokumentaufnahme wird nur angeboten, wenn die Anmeldung abgebrochen wird, abläuft oder fehlschlägt oder die Abfrage keinen Treffer liefert. |
| **Nur Wallet, kein Dokument** | Nur die Wallet (oder die Abfrage ohne Dokument). Die Dokumentaufnahme ist für das Land deaktiviert, und eine Anmeldung, die nicht abgeschlossen wird, kann erneut versucht werden: Der Benutzer bleibt im Wallet-Schritt mit „{wallet} erneut versuchen“, und die Sitzung bleibt offen, bis er fertig ist oder sie abläuft. |
| **Benutzer wählt Wallet oder Dokument** | Die Wallet oder Abfrage nebeneinander mit der Dokumentaufnahme. |
| **Nur Dokument** | Die Dokumentaufnahme. Keine Wallet und keine Abfrage wird angeboten. |

**Zuerst Wallet** schreibt `document.fallback_only` und die passenden Ausweichschalter (`wallet.on_failure` sowie die Abfrage-Schalter, wenn eine Abfrage aktiviert ist) in einem Schritt. **Nur Wallet** setzt `document.enabled` auf `false` und `wallet.on_failure` auf `retry`: Eine Anmeldung, die nicht abgeschlossen wird, kann erneut versucht werden, und die Sitzung bleibt offen, bis der Benutzer fertig ist oder sie abläuft.
Das funktioniert gleich für jede Wallet in jedem Land.
Beide sind nicht verfügbar, bis Sie eine Wallet wählen, die live ist (oder eine Abfrage aktivieren).
Eine Wallet mit dem Status **Demnächst** kann nicht vorne stehen: Solange alle Wallets eines Landes demnächst verfügbar sind, bleibt die Dokumentaufnahme an erster Stelle.
Die Länderliste zeigt **Wallet, dann Dokument** unter jedem Land, das diese Einstellung nutzt, und die Vorschau zeigt nur die Wallet.

Dieselbe Einstellung finden Sie unter **Zusätzliche Einstellungen** auf den Bildschirmen Wallets und Abfrage ohne Dokument als Schalter **Dokumentaufnahme nur als Ausweichlösung anbieten**. Beide Steuerelemente bearbeiten dieselbe Konfiguration.

### Verfügbarkeit wird vom Server gesteuert

Der Reiter liest denselben Katalog der verfügbaren Funktionen, gegen den die API validiert. Deshalb kann er Ihnen nur anbieten, was die Plattform tatsächlich unterstützt:

* Eine Methode, die der Katalog in diesem Land nicht anbietet, wird nicht als Auswahl angezeigt.
* Eine Quelle oder Wallet, die der Katalog als **Demnächst** markiert, wird aufgeführt, damit Sie die Roadmap sehen, kann aber nicht aktiviert werden.
* Die Wallet-Anmeldung wird pro Umgebung aktiviert. Solange sie aus ist, zeigt jede Wallet **Demnächst**, unabhängig davon, was der Katalog sagt.

### Smart-ID oder Mobile-ID aktivieren

Smart-ID und Mobile-ID sind in ihren unterstützten Ländern verfügbar. Die Länderabdeckung finden Sie im [Wallet-Katalog](https://docs.didit.me/de/core-technology/id-verification/digital-id-wallets.md). Prüfen Sie vor jeder Änderung an einem Workflow die Verfügbarkeit in Ihrer aktuellen Umgebung.

1. Öffnen Sie **Workflows**, wählen Sie den Workflow und seinen Knoten **Ausweisverifizierung** und öffnen Sie dann **Länder**.
2. Öffnen Sie den Länder-Editor und suchen Sie **Akzeptierte Wallets**.
3. Wählen Sie **Smart-ID** oder **Mobile-ID** nur, wenn sie verfügbar ist. Lassen Sie die Dokumentaufnahme aktiviert, wenn Sie eine Ausweichlösung wünschen.
4. Legen Sie fest, was geschehen soll, wenn eine Wallet-Anmeldung fehlschlägt, speichern Sie den Workflow und veröffentlichen Sie ihn dann.
5. Starten Sie eine neue Verifizierungssitzung mit diesem Workflow und prüfen Sie die Karte **Zugangsdaten** der abgeschlossenen Sitzung.

Der [Integrationsleitfaden für Smart-ID und Mobile-ID](https://docs.didit.me/de/core-technology/id-verification/smart-id-mobile-id.md) listet die unterstützten Ländercodes und den Vergleichscode-Ablauf auf, den der Benutzer sieht. Ein erfolgreicher Test in Staging oder Sandbox aktiviert die Wallet nicht in der Produktion.

### Erwartete Anfrage und Antwort

Wenn Sie bei einer Abfragequelle oder einer Wallet **Details ansehen** auswählen, werden die erwartete Anfrage und Antwort geöffnet: wozu der Endbenutzer in einfacher Sprache aufgefordert wird und was die Quelle zurückgibt. Jede Abfragequelle wird genau benannt, in den meisten Ländern ein Behördenregister, in manchen eine Auskunftei oder ein Melderegister, denn das bestimmt die Herkunft und das Einwilligungsregime. Der Endbenutzer sieht die Antwortfelder, den Quellennamen oder den Preis nie.

### Massenumschalter

**Globale Einstellungen** schaltet eine Methode in jedem Land ein, das sie unterstützt, sodass Sie nicht 36 Länder einzeln durchgehen müssen. Der Editor für das einzelne Land hat trotzdem Vorrang: Schalten Sie eine Methode global ein und deaktivieren Sie sie dann für das eine Land, in dem Sie sie nicht wollen.

## Preise im Tab

Die Dokumentenerfassung zeigt ihren Preis: \$0.15 pro Verifizierung. Eine Abfrage ohne Dokument zeigt ihren Preis pro Land. Ein Preis, den der Preiskatalog noch nicht veröffentlicht hat, wird im Tab als Platzhalter gekennzeichnet und nicht als Angebot dargestellt. Eine Wallet-Zeile zeigt die Wallet, ihre Abdeckung und ihre Verfügbarkeit.

Der Tab nennt außerdem die Abrechnungsfolgen jedes Fallback-Schalters bei Abfragen, damit Sie die Kosten einer Konfiguration sehen, bevor Sie sie speichern:

* Eine Abfrage bei einem Register, das geantwortet hat, wird abgerechnet: Sowohl ein Treffer als auch kein Treffer zählen. Wechselt der Nutzer anschließend zum Dokument, wird die Dokumentenerfassung zusätzlich abgerechnet.
* Eine Abfrage, die nie ein Ergebnis geliefert hat, wird nicht abgerechnet. Ein Ausfall kostet Sie daher nur den Dokumentenpreis.
* Schalten Sie einen Fallback aus, werden diese Nutzer abgelehnt; es fällt keine weitere Gebühr an.

## Eine Sitzung auswerten

Der Block **Ausweisverifizierung** in den Sitzungsdetails enthält einen Chip für die Methode, mit der die Verifizierung durchgeführt wurde, und einen zweiten Chip für deren [Vertrauensstufe](https://docs.didit.me/de/core-technology/id-verification/verification-methods.md#vertrauensstufen): **Dokument / Documentary**, **Abfrage ohne Dokument / Data match** oder den Namen der Wallet mit **Cryptographic**.

> [!NOTE]
>
> Eine Sitzung, die von einer Methode ohne Dokument auf die Dokumentenerfassung zurückgefallen ist, wird als Sitzung **Dokument / Documentary** angezeigt. [`fallback_from`](https://docs.didit.me/de/reference/data-models#ausweisverifizierung) im Block **Ausweisverifizierung** nennt die Methode, die zuerst versucht wurde, und den Grund, warum sie geendet hat (zum Beispiel `wallet` und `cancelled`), mit `action: "fallback_to_document"`.

Unter den Chips zeigt jede Methode ihre eigenen Nachweise:

* **Dokument**: unverändert, also die Bilder von Vorder- und Rückseite sowie das Selfie, die Qualitätswerte, die extrahierten Felder und die Warnungen.
* **Abfrage ohne Dokument**: ein **Registerabgleich**, der jedes verglichene Feld auflistet, mit dem, was der Nutzer angegeben hat, dem, was die Quelle hinterlegt hatte, und einem Ergebnis **Treffer**, **Teilweise** oder **Kein Treffer**. Dazu kommen der Name der Quelle, der Zeitpunkt der Prüfung und die Anzahl der Versuche. Eine Quelle, die nicht geantwortet hat, erscheint als eigene Zeile mit einem Fehler statt eines Ergebnisses für das jeweilige Feld. Hat die Quelle ein Porträt zurückgegeben, werden dieses Porträt und das Selfie des Nutzers nebeneinander mit dem Gesichts-Score angezeigt.
* **Wallet**: die Karte **Credential** mit der Wallet, ihrer ausstellenden Stelle, dem Typ des Nachweises, dem von ihr bestätigten Sicherheitsniveau, dem Zeitpunkt der Prüfung, der Angabe, ob die Signatur gültig war, und den Attributen, die die Wallet geteilt hat.

Wo eine Quelle oder eine Wallet kein Porträt teilt, zeigt das Panel dies an, statt einen leeren Rahmen zu lassen: Es gibt dann nichts, womit ein Gesichtsabgleich durchgeführt werden kann, und Liveness-Erkennung sowie Gesichtsabgleich laufen als eigene Schritte, falls der Workflow sie enthält.

## Verwandte Themen

* [Ausweisverifizierungsmethoden](https://docs.didit.me/de/core-technology/id-verification/verification-methods.md): die drei Methoden, Fallback und Abrechnung
* [Abfrage ohne Dokument](https://docs.didit.me/de/core-technology/id-verification/non-doc-lookup.md): Felder je Land und Einwilligung
* [Digitale ID-Wallets](https://docs.didit.me/de/core-technology/id-verification/digital-id-wallets.md): Attribute und Sicherheitsniveau je Wallet
* [Workflows](https://docs.didit.me/de/console/workflows.md): Erstellen und Veröffentlichen eines Workflows
* [Workflow-Feature-Konfigurationen](https://docs.didit.me/de/management-api/workflows/feature-configs.md#ocr-/-ausweisverifizierung): dieselben Einstellungen über die API


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.