cryptographic auf: Ein Identitätsanbieter hat die Person authentifiziert und die zurückgegebenen Attribute signiert. Das ist alles, was diese Stufe aussagt. Sie stellt keine Rangfolge gegenüber den anderen beiden Stufen dar – diese beschreiben andere Nachweise, nicht mehr oder weniger von derselben Sache –, und wie lange eine Anmeldung dauert, hängt vom eigenen Ablauf der Wallet ab, den Didit weder steuert noch zusichert.
Wählen Sie Ihre Integration aus
Verwenden Sie die APIs für digitale ID-Wallets, wenn Ihre Anwendung die Benutzeroberfläche und die Authentifizierungsschritte verwaltet. Jede Wallet verfügt über einen dedizierten Start-Endpoint sowie gemeinsame Endpoints für Ergebnisse, Polling und Abbrüche. Sie müssen keinen Workflow erstellen. Verwenden Sie die Sessions API für Didits gehosteten Wallet-Ablauf, Workflow-Regeln und einen konfigurierten Dokumenten-Fallback. Die Verfügbarkeit der Wallet, die erforderliche Benutzerzustimmung und die verifizierten Identitätsattribute gelten für beide Integrationsmethoden.Voraussetzungen
Jede Wallet erfordert eine aktive Identität beim unten genannten Aussteller sowie Zugriff auf dessen Authentifizierungsmethode. Das Konto muss für die angeforderten Attribute berechtigt sein, und der Benutzer muss der Weitergabe zustimmen. Eine Signatur verifiziert den Aussteller und die zurückgegebenen Claims; sie garantiert nicht, dass jedes angeforderte Attribut vorhanden, aktuell oder ausreichend für Ihre Compliance-Richtlinie ist. Eine Wallet ohne Porträtfoto beinhaltet keinen Selfie-Abgleich. Alle 25 Wallet-Einträge des Katalogs sind unten aufgeführt, einschließlich beider BankID-Länder, ConnectID, Estonian ID-card und eParaksts mobile. Ein konfigurierter Dokumenten-Fallback führt eine separate Dokumentenprüfung durch. Es wird kein Starttermin zugesichert. Hierbei handelt es sich um Identitäts-Wallets. Krypto-Wallet-Screening prüft Blockchain-Adressen auf finanzielle Risiken und ist ein separates Produkt.Preise
✅ Verfügbar bedeutet, dass die Wallet in der Produktion aktiviert ist. ⏳ Demnächst verfügbar bedeutet, dass die Wallet noch nicht in der Produktion aktiviert ist, selbst wenn Integrationstests bereits begonnen haben. Verfügbare Wallets werden zuerst aufgeführt. Auf Anfrage in der Preisspalte bedeutet, dass das Wallet verfügbar ist, aber kein veröffentlichter Endkundentarif vorliegt; dies bedeutet keine kostenlose Verifizierung. Dies sind Didits Standardpreise in USD pro abgeschlossener Wallet-Verifizierung für die unten aufgeführten Identitätsprodukte. Der angegebene Preis beinhaltet die Wallet-Identitätsprüfung; es wird keine separate Transaktionsgebühr für nationale eIDs hinzugefügt. Ein vereinbarter organisationsspezifischer Tarif hat Vorrang.
Demnächst in der Preisspalte bedeutet, dass die Wallet geplant ist und ihr Kundenpreis noch nicht veröffentlicht wurde. Es bedeutet nicht, dass die Verifizierung kostenlos ist. Länderflaggen zeigen die Katalogabdeckung der Wallet; die separate Verfügbarkeitsspalte zeigt, ob sie derzeit aktiviert werden kann.
Ein veröffentlichter Preis aktiviert eine Wallet nicht. Die obige Verfügbarkeit stammt aus dem Produktionskatalog. Eine als Demnächst markierte Wallet kann in einem Workflow noch nicht ausgewählt werden; diese Tarife gelten, sobald sie verfügbar wird.
- Eine verifizierte Wallet-Anmeldung wird einmal pro Ausweisverifizierungs-Knoten in einem Workflow oder einmal pro Verifizierungsanfrage über die eigenständige Wallet-API abgerechnet. Wiederholte Callbacks oder Statusprüfungen verursachen keine weitere Gebühr.
- Abgebrochene, abgelaufene, abgelehnte oder unvollständige Anmeldungen verursachen keine Gebühr für die Wallet-Verifizierung.
- Wallet-Preise sind Listenpreise: Ihr Tarifrabatt gilt für sie wie für jede andere Prüfung.
- Ein Dokumenten-Fallback ist eine separate Prüfung, die gemäß den Preisen für die Dokumentenverifizierung abgerechnet wird. Andere abgeschlossene Workflow-Funktionen werden separat abgerechnet.
Was der Benutzer tut
- Wählt sein Land im ID-Schritt aus und entscheidet sich für eine Wallet aus den von Ihnen akzeptierten Wallets.
- Meldet sich mit dieser Wallet an, so wie er sich bei seiner Bank oder seinem Behördenportal anmeldet.
- Stimmt der Weitergabe seiner Identitätsattribute an Sie zu.
- Kommt verifiziert zurück.
Wallets sind eine Positivliste
wallet.providers ist die Liste der Wallets, die ein Land anbieten kann. Es ist keine Rangfolge: Die Reihenfolge, die Sie übermitteln, hat keine Bedeutung, wird beim Speichern in die Katalogreihenfolge normalisiert, und der Endbenutzer wählt aus den von Ihnen akzeptierten Wallets. Aktivieren Sie eine Wallet oder jede Wallet in einem Land – die Entscheidung liegt bei ihm.
Die API lehnt einen Workflow ab, der eine Wallet aktiviert, die der Katalog in diesem Land nicht anbietet, oder eine, die noch mit Demnächst gekennzeichnet ist.
Die unten aufgeführte Attributliste jeder Wallet enthält eine signierte Attestierung. Didit prüft diese Signatur und meldet das Ergebnis als
wallet_verification.signature_valid in der Sitzung; die Attestierung selbst wird nicht zurückgegeben, sodass es keine Referenz zum Abrufen oder Speichern gibt. Die Spalte In der Sitzung gibt an, welches von beiden Sie für jedes Attribut erhalten.Unterstützte Wallets
Die verfügbaren Wallets sind MitID, BankID Sweden, iDIN, Finnish Trust Network, Smart-ID und Mobile-ID. iDIN ist für die vollständige Identifizierung in den Niederlanden verfügbar. Smart-ID und Mobile-ID sind in den im nachstehenden Katalog aufgeführten Ländern verfügbar. Die Länderabdeckung und die angeforderten Eingaben für Smart-ID und Mobile-ID spiegeln die implementierte Integration wider; die Verfügbarkeit in der Produktion wird weiterhin separat gesteuert. Nutzen Sie den Integrationsleitfaden für die implementierten Smart-ID- und Mobile-ID-Routen.Die Verfügbarkeit wird über den Funktionskatalog bereitgestellt und hier nicht manuell gepflegt. Demnächst bedeutet, dass die Wallet in der Konsole sichtbar ist, aber noch nicht aktiviert werden kann; dies beinhaltet kein verbindliches Datum.
Estnische ID-Karte und eParaksts mobile
Beide Methoden sind in den Wallet-Katalog integriert, haben in der Produktionsumgebung jedoch weiterhin den Status Demnächst. Sie können in Produktions-Workflows erst aktiviert werden, wenn der Produktionskatalog sie als Verfügbar ausweist. Die API-Bezeichner lautenidcard_ee für Estland (EST) und eparaksts_mobile für Lettland (LVA).
Beide kosten bei Verfügbarkeit $0.55 pro abgeschlossener Verifizierung; ein veröffentlichter Preis schaltet den Produktionszugriff nicht frei.
- Estnische ID-Karte: Der Benutzer setzt die Nutzung im Browser auf dem Computer fort, der mit seinem Smartcard-Lesegerät verbunden ist, und authentifiziert sich über die Kartensoftware mit seiner Karte und PIN.
- eParaksts mobile: Der Benutzer wird zum Identitäts-Anmeldedienst weitergeleitet und autorisiert die Verifizierung mit seinem aktiven eParaksts mobile-Konto. Desktop-Benutzer können den QR-Code scannen, um auf ihrem Smartphone fortzufahren; Smartphone-Benutzer fahren direkt fort.
White-Label gilt für die Verifizierungsbildschirme von Didit.
Die externen Authentifizierungsbildschirme dieser beiden Methoden behalten das Branding ihres jeweiligen Dienstes bei.
Benutzerdefinierte Logos, Dienstnamen und White-Label-Styling werden nicht auf diese externen Bildschirme übertragen.
Diese Wallets über die API nutzen
Beide Methoden unterstützen auch die eigenständige API-Verifizierung ohneworkflow_id.
Die Verfügbarkeit in der Produktionsumgebung ist für die eigenständige API und für Workflows identisch; rufen Sie GET /v3/id-verification/wallets/ ab, bevor Sie Benutzern eine der Methoden anbieten.
Verwahren Sie Ihren
x-api-key auf Ihrem Backend und registrieren Sie den Return-Host Ihrer Anwendung in deren Einstellung allowed_return_hosts.
Übermitteln Sie beim Starten einer Verifizierung eine HTTPS-return_url auf diesem Host.
Die Start-Antwort gibt eine request_id und eine wallet_verification.next_action.url für den Browser des Benutzers zurück.
Leiten Sie den Benutzer auf diese URL weiter, damit er sich mit seiner Karte oder App authentifizieren kann.
Rufen Sie nach seiner Rückkehr von Ihrem Backend aus GET /v3/id-verification/wallets/verifications/{request_id}/ auf, um das verifizierte Ergebnis zu prüfen, oder verarbeiten Sie den signierten Webhook status.updated.
Werten Sie die Browser-Weiterleitung allein nicht als Nachweis einer erfolgreichen Verifizierung.
Für beide Integrationsoptionen gelten dieselben Regeln für Preise und die Abrechnung nach abgeschlossener Verifizierung.
Google Wallet
Mit Google Wallet kann eine Person über die W3C Digital Credentials API einen behördlichen Ausweis von ihrem Smartphone aus für Ihre Seite oder App freigeben. Es ist in der Produktionsumgebung und in der Sandbox verfügbar. Sandbox-Anwendungen erfordern keine Registrierung. Jede Produktionsanwendung muss einmalig registriert werden, bevor sie Google Wallet nutzen kann: Öffnen Sie in der Konsole den Schritt für die Ausweisverifizierung, suchen Sie die Zeile für Google Wallet eines unterstützten Landes, wählen Sie Bei Google registrieren und schließen Sie die einmalige Einrichtung ab, die etwa eine Minute dauert. Google zeigt anschließend Ihren Namen und Ihr Logo an, wenn Personen ihren Ausweis freigeben. Bis die Anwendung registriert ist, wird das Speichern eines Workflows, der Google Wallet aktiviert, mit der Meldung „Registrieren Sie diese Anwendung bei Google, bevor Sie Google Wallet aktivieren.“ abgelehnt. Die Endbenutzer Ihrer Kunden sehen die Option als Verify with digital ID, da neben Google Wallet auch jede andere Android-Wallet, die dieselbe OpenID4VP-Anfrage unterstützt und einen kompatiblen Ausweis enthält (einen ID-Pass oder einen mobilen Führerschein), darauf reagieren kann.- Länder: Vereinigte Staaten, Vereinigtes Königreich, Brasilien, Singapur und Taiwan.
- Nachweise: der aus einem Reisepass erstellte Google Wallet ID-Pass sowie mobile Führerscheine aus unterstützten US-Bundesstaaten.
- Rückgabewerte: Name, Geburtsdatum, Dokumentennummer, Ablaufdatum des Dokuments, Ausstellungsland und ausstellende Behörde sowie die Staatsangehörigkeit bei einem ID-Pass.
Das Ergebnis enthält außerdem das Ergebnis
signature_validfür den Nachweis. Es wird kein Porträtfoto übermittelt. - Datenschutz: Didit fordert nur die benötigten Felder an, und nur diese Felder verlassen die Wallet. Die Person bestätigt die Freigabe in Google Wallet auf ihrem eigenen Gerät.
allow-Attribut Ihres iframes digital-credentials-get hinzu: Ohne dieses Attribut verweigert der Browser die Wallet-Anfrage innerhalb des iframes.
Weitere künftig verfügbare Wallets
ConnectID (Australien) ist für Sandbox-Tests integriert und erscheint im Wallet-Katalog alsconnectid.
Die Person wählt über die ConnectID-Auswahl eine teilnehmende Testbank aus, meldet sich bei dieser Bank an und überprüft die Freigabeanfrage.
Das anfängliche Identitäts-Bundle fragt Vorname, Nachname und Geburtsdatum ab, zusammen mit einer Transaktionsreferenz für die Verifizierung.
Es fordert keine Adresse, Telefonnummer, E-Mail-Adresse, keinen Kontostand und keinen Transaktionsverlauf an.
Der Freigabehinweis identifiziert Didit und das Unternehmen, das die verifizierte Identität empfängt.
Bank-Zugangsdaten verbleiben bei der Bank.
Der Produktionszugang ist weiterhin mit Demnächst gekennzeichnet; Sandbox-Tests ermöglichen keine Live-Identitätsverifizierung.
Ein genehmigter Produktions-Anwendungsfall, Kunden-Onboarding, erforderliche Bedingungen und eine Zertifizierung müssen vor der Aktivierung abgeschlossen sein.
Andere in den Tabellen als Demnächst gekennzeichnete Wallets bleiben in der Produktion ebenfalls nicht verfügbar.
Es wird kein Startdatum zugesagt.
Vertrauensniveau
Wenn eine Wallet ein eIDAS-Vertrauensniveau (low, substantial oder high) bereitstellt, erfasst Didit das im Ergebnis tatsächlich angegebene Niveau.
Eine Wallet ohne angegebenes eIDAS-Niveau, wie etwa ConnectID, wird als Nicht angegeben angezeigt; ihre Integration bedeutet nicht, dass ein eIDAS-Vertrauensniveau vorliegt.
Wenn eine Wallet ein niedrigeres Niveau als das angeforderte zurückgibt, schlägt die Anmeldung fehl, anstatt das angeforderte Niveau stillschweigend herabzustufen.
Prüfen Sie wallet_verification.level_of_assurance in der Sitzung, wenn Ihre Compliance-Regeln davon abhängen.
Referenz pro Wallet
MitID
mitid · Verfügbar
In Didit eingegebene Informationen: Name · Geburtsdatum · CPR-Alias (pseudonymisiert)
BankID
bankid_se · Verfügbar
In Didit eingegebene Informationen: Name · Personennummer
iDIN
idin · Verfügbar
In Didit eingegebene Informationen: Name · Geburtsdatum · Adresse
Finnish Trust Network
ftn · Verfügbar
In Didit eingegebene Informationen: Name · Persönlicher Identifikationscode
Google Wallet
google_wallet · Verfügbar
In Didit eingegebene Informationen: Keine Identitätsdaten in Didit eingegeben
Smart-ID
smart_id · Verfügbar
In Didit eingegebene Informationen: Persönlicher Identifikationscode
Mobile-ID
mobile_id · Verfügbar
In Didit eingegebene Informationen: Persönlicher Identifikationscode · Mobile-ID-Telefonnummer
BankID
bankid_no · Demnächst verfügbar
In Didit eingegebene Informationen: Name · Geburtsdatum · Nationale Identitätsnummer
Vipps
vipps · Demnächst verfügbar
In Didit eingegebene Informationen: Name · Geburtsdatum · Nationale Identifikationsnummer
Buypass ID
buypass · Demnächst verfügbar
In Didit eingegebene Informationen: Name · Geburtsdatum · Nationale Identifikationsnummer
itsme
itsme · Demnächst verfügbar
In Didit eingegebene Informationen: Name · Geburtsdatum · Nationalregisternummer
Personalausweis
personalausweis · Demnächst verfügbar
In Didit eingegebene Informationen: Name · Geburtsdatum · Staatsangehörigkeit · Adresse
Freja eID
frejaid · Demnächst verfügbar
In Didit eingegebene Informationen: Name · Geburtsdatum · Personennummer
UAE PASS
uae_pass · Demnächst verfügbar
In Didit erfasste Informationen: Name · Emirates-ID-Nummer · Staatsangehörigkeit · Porträtfoto
gov.br
govbr · Demnächst verfügbar
In Didit erfasste Informationen: Name · CPF
OneID
oneid · Demnächst verfügbar
In Didit erfasste Informationen: Name · Geburtsdatum
GOV.UK Wallet
govuk_wallet · Demnächst verfügbar
In Didit erfasste Informationen: Name · Geburtsdatum · Porträtfoto
Estnische ID-Karte
idcard_ee · Demnächst verfügbar
In Didit erfasste Informationen: Name · Geburtsdatum · Personenkennziffer
eParaksts mobile
eparaksts_mobile · Demnächst verfügbar
In Didit erfasste Informationen: Name · Geburtsdatum · Personenkennziffer
Bank iD
bankid_cz · Demnächst verfügbar
In Didit erfasste Informationen: Name · Geburtsdatum
MojeID
mojeid · Demnächst verfügbar
In Didit erfasste Informationen: Name · Geburtsdatum
Diia
diia · Demnächst verfügbar
In Didit erfasste Informationen: Name · Geburtsdatum · Porträt
FranceConnect
franceconnect · Demnächst verfügbar
In Didit erfasste Informationen: Name · Geburtsdatum
Auðkenni
audkenni · Demnächst verfügbar
In Didit eingegebene Informationen: Name · Kennitala
ConnectID
connectid · Demnächst verfügbar
In Didit eingegebene Informationen: Keine Identitätsdaten in Didit eingegeben
EUDI Wallet
eudi · Demnächst verfügbar
In Didit eingegebene Informationen: PID – Personenidentifizierungsdaten
Fehler und Fallback
Jedes andere Ergebnis als
verified wird gemäß der Ländereinstellung wallet.on_failure verarbeitet: fallback_to_document leitet den Benutzer zur Dokumentenerfassung weiter, decline beendet die Sitzung mit einer abgelehnten Ausweisverifizierung. Ist die Dokumentenerfassung für dieses Land deaktiviert, führt fallback_to_document stattdessen zu einer Ablehnung, da kein Fallback verfügbar ist.
Wie Sie die Dokumentenerfassung erst nach einer fehlgeschlagenen Wallet-Anmeldung anzeigen, erfahren Sie unter Dokumentenerfassung nur als Fallback anbieten.
Nur eine abgeschlossene Anmeldung wird abgerechnet. Abgebrochene, stornierte, abgelaufene und fehlgeschlagene Anmeldungen sind kostenlos.
Welche Daten in der Sitzung verfügbar sind
attributes enthält die validierten Wallet-Angaben, deren Bezeichnungen je nach Wallet variieren.
Verwenden Sie full_name und date_of_birth im Ergebnis der Ausweisverifizierung für die normalisierten Identitätsfelder.
Die Tabelle pro Wallet unterscheidet diese normalisierten Felder von wallet-spezifischen Attributen. portrait ist nur bei Wallets vorhanden, die ein Porträtfoto übermitteln. signature_valid ist das Ergebnis der Validierung der signierten Zusicherung, die die Wallet zurückgegeben hat. Bei einer abgeschlossenen Anmeldung ist der Wert true: Eine Zusicherung, die sich nicht validieren lässt, führt zum Fehlschlagen der Anmeldung und wird stattdessen gemäß wallet.on_failure verarbeitet, anstatt ein genehmigtes Ergebnis zu erzeugen.
Die vollständigen Feldtypen finden Sie im Datenmodell der Ausweisverifizierung.
Wallets konfigurieren
Verwenden Sie dieses Konfigurationsfragment nur dann, wenn der Katalog Ihrer Umgebung jede ausgewählte Wallet im betreffenden Land alsavailable kennzeichnet.
Wird eine Wallet übermittelt, die nicht verfügbar ist, wird das Speichern des gesamten Workflows abgelehnt – einschließlich aller anderen Methoden in derselben Anfrage.
Beispiele für Smart-ID und Mobile-ID finden Sie im Integrationsleitfaden.
wallet.enabled den Wert true hat, andernfalls wird das Speichern abgelehnt. Die vollständige Referenz finden Sie unter Workflow-Funktionskonfigurationen.
Verwandte Themen
- Integration des Finnish Trust Network – Finnland, Bank-Authentifizierung und Dokumenten-Fallback
- Integration von Smart-ID und Mobile-ID – Länderabdeckung, Vergleichscodes und Workflow-Konfiguration
- Methoden der Ausweisverifizierung – die drei Methoden, Fallback und Abrechnung
- Nicht-dokumentenbasierter Abgleich – die Datenabgleichsmethode
- Methoden der Ausweisverifizierung in der Konsole – Wallets pro Land aktivieren