Zum Hauptinhalt springen
POST
cURL
Starten Sie die Google-Wallet-ID-Verifizierung von Ihrem Backend aus mit dem API-Schlüssel Ihrer Anwendung. Sie benötigen weder einen Workflow noch eine workflow_id. Die Antwort beim Start beschreibt die nächste Authentifizierungsaktion; sie ist kein genehmigtes Identitätsergebnis.

Abdeckung und Aktivierung

Die Aktivierung der Wallet ist unabhängig von der API-Bereitstellung und der Berechtigung Ihrer Anwendung. Ein dokumentierter Endpoint aktiviert keine Wallet, die als Demnächst verfügbar gekennzeichnet ist. Aktuelle veröffentlichte Preise finden Sie unter Preise für digitale ID-Wallets.

Was die Person tut

Ihre Seite oder App fragt Google Wallet direkt ab: Es gibt keine Weiterleitung und keine von Didit gehostete Seite. Übergeben Sie next_action.digital_credentials.request in einer Benutzeraktion auf dem origin, mit dem Sie gestartet haben, an navigator.credentials.get({digital: request}), oder an den Android Credential Manager als GetDigitalCredentialOption. Senden Sie anschließend die Antwort der Wallet an Wallet-Antwort übermitteln. Der Browser bietet einen eigenen QR-Code an, wenn sich die Wallet auf einem anderen Gerät befindet.

Ergebnis empfangen

Folgen Sie dem Leitfaden zur API für digitale ID-Wallets, um die Verifizierung nachzuverfolgen und ihr Ergebnis abzurufen. Betrachten Sie nur ein abgeschlossenes, verifiziertes Ergebnis als Nachweis dafür, dass die Wallet die Person authentifiziert hat. Die zurückgegebenen Identitätsattribute variieren je nach Wallet; gehen Sie nicht davon aus, dass eine Adresse, ein Porträt oder alle angefragten Attribute vorhanden sind.

Verwandte Themen

Autorisierungen

x-api-key
string
header
erforderlich

Der API-Schlüssel Ihrer Anwendung, aus Entwickler -> API-Schlüssel in der Business Console. Der Primärschlüssel hat Vollzugriff. Ein benannter Schlüssel kann im Geltungsbereich eingeschränkt werden: keine, Lese- oder Schreibberechtigung pro Ressource, beschränkt auf bestimmte Workflows oder genehmigte Sitzungen, auf eine Liste von IP-Adressen und auf ein Ablaufdatum. 401 bedeutet, dass der Schlüssel falsch, widerrufen oder abgelaufen ist; 403 bedeutet, dass kein Schlüssel gesendet wurde, der Schlüssel keinen Zugriff auf diese Ressource oder Aktion hat oder die Anfrage von einer Adresse außerhalb seiner IP-Liste stammte; 404 bei einer Sitzungsroute bedeutet, dass die Sitzung außerhalb der Workflows oder Status des Schlüssels liegt. Ein Schlüssel ohne Medienzugriff erhält Bild-, Video- und PDF-URLs als null, und ein Schlüssel ohne Schreibberechtigung für Sitzungen erhält Sitzungslinks und Token als null. Siehe https://docs.didit.me/console/api-keys.

Header

Idempotency-Key
string

Optionaler Schlüssel zur Wiederholungssicherheit (max. 255 Zeichen). Ein erneuter Versuch mit demselben Schlüssel, derselben Wallet und demselben Body gibt die ursprüngliche Verifizierung zurück, ohne eine zweite Anmeldung zu starten; derselbe Schlüssel mit einer anderen Wallet oder einem anderen Body gibt 409 idempotency_key_reused zurück.

Body

Starten Sie eine Google-Wallet-Verifizierung (USA, GBR, BRA, SGP, TWN).

country
enum<string>
erforderlich

ISO 3166-1-Alpha-3-Land der Google Wallet-Identität.

  • USA - USA
  • GBR - GBR
  • BRA - BRA
  • SGP - SGP
  • TWN - TWN
Verfügbare Optionen:
USA,
GBR,
BRA,
SGP,
TWN
origin
string
erforderlich

Wo Ihre Seite oder App die Wallet anfragt: der https-Origin Ihrer Seite (sein Host muss in den allowed_return_hosts der Anwendung enthalten sein oder deren White-Label-Domain sein), z. B. https://app.example.com, oder android:apk-key-hash:<base64 SHA-256 des Signaturzertifikats Ihrer App, ohne Padding>. Die Wallet lehnt die Anfrage überall sonst ab.

Required string length: 1 - 256
vendor_data
string | null

Ihre eigene Referenz für diese Verifizierung (z. B. Ihre Benutzer-ID). Wird in Ergebnissen und Webhooks zurückgegeben.

metadata
object | null

Optionales JSON-Objekt, das mit der Verifizierung gespeichert und in Ergebnissen sowie Webhooks zurückgegeben wird.

sandbox_scenario
string

Nur für Sandbox-Anwendungen: Das simulierte Ergebnis – 'wallet_cancelled', 'wallet_timeout' oder 'wallet_provider_error'; jedes andere Szenario (oder keines) verifiziert erfolgreich. Bei Live-Anwendungen abgelehnt. Der vollständige Katalog ist unter GET /v1/sandbox/scenarios/ verfügbar.

Minimum string length: 1

Antwort

Eine eigenständige Wallet-Verifizierung, wie sie von jedem Wallet-Endpoint beantwortet wird.

request_id
string<uuid>
erforderlich
wallet_verification
object
erforderlich
vendor_data
string | null
erforderlich
metadata
object | null
erforderlich

Das beim Start gesendete Metadaten-Objekt oder null.

created_at
string<date-time>
erforderlich
Zuletzt geändert am 7. November 2026