Zum Hauptinhalt springen
Die Wallet-Anmeldung ist eine der drei Methoden zur Ausweisverifizierung. Der Benutzer meldet sich mit einer digitalen Identität an, die er bereits besitzt – einer nationalen eID oder einer Bankidentität –, und dieser Anbieter übermittelt Didit einen signierten Satz von Attributen. Das Ergebnis weist die Vertrauensstufe 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.
Die Verfügbarkeit hängt von Ihrer Umgebung ab. Die nachstehenden Tabellen beschreiben die Verfügbarkeit in der Produktion, und die Konsole verwendet den Live-Funktionskatalog ihrer Umgebung, wenn Sie einen Workflow speichern. MitID, BankID Sweden, iDIN, Finnish Trust Network, Smart-ID und Mobile-ID sind verfügbar. Estonian ID-card, eParaksts mobile, Personalausweis, OneID und ConnectID bleiben in der Produktion auf Demnächst. Smart-ID unterstützt Estland, Lettland, Litauen und Belgien; Mobile-ID unterstützt Estland und Litauen; Finnish Trust Network unterstützt Finnland. Länderabdeckung, Konfiguration und den Verifizierungsablauf finden Sie im Integrationsleitfaden für Smart-ID und Mobile-ID. Eine als Demnächst gekennzeichnete Wallet kann in dieser Umgebung nicht aktiviert werden.

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.
Beispielsweise kosten 1.000 abgeschlossene iDIN-Verifizierungen zur vollständigen Identifizierung zum Standardtarif $950, ohne die Kosten für weitere Workflow-Funktionen. Dies ist eine vollständige Identifizierung; es handelt sich nicht um einen Preis für wiederholte Anmeldungen. Der obige BankID-Tarif gilt für Norwegen High, und der deutsche eID-Tarif gilt für Personalausweis Profil 2.

Was der Benutzer tut

  1. Wählt sein Land im ID-Schritt aus und entscheidet sich für eine Wallet aus den von Ihnen akzeptierten Wallets.
  2. Meldet sich mit dieser Wallet an, so wie er sich bei seiner Bank oder seinem Behördenportal anmeldet.
  3. Stimmt der Weitergabe seiner Identitätsattribute an Sie zu.
  4. Kommt verifiziert zurück.
Die Anmeldung auf demselben Gerät leitet den Benutzer an die Wallet-App weiter und bringt ihn nach Abschluss zurück zum Verifizierungsablauf. Die Anmeldung geräteübergreifend zeigt einen QR-Code auf dem Desktop-Bildschirm an, den er mit dem Smartphone scannt, auf dem sich die Wallet befindet. Beides wird angeboten, sofern die Wallet dies unterstützt; der Benutzer wählt aus. Wenn Smart-ID oder Mobile-ID für Ihren Workflow aktiviert ist, gibt der Benutzer seinen persönlichen Identifikationscode auf der Verifizierungsseite ein. Mobile-ID fragt zusätzlich nach der mit der Identität verknüpften Telefonnummer. Die Seite zeigt einen Kontrollcode an, und der Benutzer bestätigt auf seinem Smartphone nur, wenn dieser Code übereinstimmt. Der Benutzer gibt seine PIN auf seinem Smartphone ein; Didit fragt diese niemals ab. Dieser Ablauf funktioniert vom Desktop oder Smartphone aus ohne QR-Code. Die Verfügbarkeit wird durch den Live-Funktionskatalog bestimmt; eine als Demnächst markierte Wallet kann noch nicht aktiviert werden. Eine gestartete Anmeldung bleibt für ein begrenztes Zeitfenster gültig (standardmäßig 10 Minuten). Danach muss der Benutzer sie erneut starten.

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 lauten idcard_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.
Beide nutzen den gemeinsamen Ablauf von Didit für Wallet-Auswahl, Übergabe und Rückkehr. Der Benutzer gibt seine Authentifizierungs-PIN ausschließlich im Identitätsdienst oder in der Kartensoftware ein, niemals in ein Didit-Formular. Nach der Authentifizierung überprüft Didit die signierten Identitätsattribute und setzt den konfigurierten Workflow fort. Bei einem Abbruch oder Fehler greift der im Workflow konfigurierte Dokumenten-Fallback oder die Ablehnungsaktion.
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 ohne workflow_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_valid fü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.
Es gibt keine Weiterleitung: Die Person bestätigt direkt in der Wallet-Eingabeaufforderung des Browsers oder von Android, und Desktop-Browser zeigen einen eigenen QR-Code an, wenn sich die Wallet auf einem Smartphone befindet. Die Verifizierung wird von Ihrer Seite oder App angefordert, daher benötigt die API-Integration den HTTPS-Origin Ihrer Seite. Der gehostete Ablauf über die Sessions API bietet die Methode nur auf Browsern und Geräten an, die sie unterstützen, und behält andernfalls den Dokumenten-Fallback bei. Wenn Sie den gehosteten Ablauf innerhalb Ihrer eigenen Seite anzeigen, verwenden Sie das Web SDK Version 0.5.1 oder neuer oder fügen Sie dem 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 als connectid. 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 als available 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.
Aktivieren Sie mindestens eine Wallet, wenn wallet.enabled den Wert true hat, andernfalls wird das Speichern abgelehnt. Die vollständige Referenz finden Sie unter Workflow-Funktionskonfigurationen.

Verwandte Themen

Zuletzt geändert am 7. November 2026