Zum Hauptinhalt springen
Der Schritt Ausweisverifizierung 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 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. 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: 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. 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 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: Dokument / Documentary, Abfrage ohne Dokument / Data match oder den Namen der Wallet mit Cryptographic.
Eine Sitzung, die von einer Methode ohne Dokument auf die Dokumentenerfassung zurückgefallen ist, wird als Sitzung Dokument / Documentary angezeigt. fallback_from 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

Zuletzt geändert am 7. November 2026