> ## 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.

# Identitätsverifizierung: Prüfung bei Registrierung und vor Auszahlungen

> Didit verlangt vor der Kontoerstellung Liveness- oder Ausweisprüfung, prüft vor Auszahlungen erneut und liefert verifizierte Claims im Token.

Die verifizierte Identität von Didit Authentication fordert Personen an den Zeitpunkten, die Sie wählen, zum Nachweis ihrer Identität auf: bevor ihr Konto angelegt wird und erneut vor einer sensiblen Aktion, etwa einer Auszahlung.
Ihre App erhält das Ergebnis und die verifizierten Claims, die Sie ausgewählt haben, etwa `over_18` oder einen verifizierten Namen, in den Tokens der Person, niemals deren Dokumente oder Fotos.

Richten Sie es in der Business Console unter **Authentication > Verified identity** ein oder per API mit [`verified/`](#einrichtung-über-die-api).

![Die Seite Verified identity in der Didit Business Console mit den Verifizierungsstufen bei der Registrierung und deren Preisen sowie den Step-up-Regeln vor sensiblen Aktionen](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-verified-identity.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=98544caeedf5ffaf68484cace19f9b3f)

Authentication > Verified identity: die Prüfung bei der Registrierung und die Regeln vor sensiblen Aktionen.

## Wie es funktioniert

Jede Prüfung läuft als Verifizierungssitzung Ihrer eigenen Anwendung, die mit dem `vendor_data` der Person erstellt wird.
Das bedeutet, dass sie in Ihren Verifizierungen und für dieselbe Person zusammen mit deren Anmeldungen und Transaktionen erscheint, wie jede andere Verifizierung an die manuelle Prüfung weitergeleitet wird und zum Preis dieser Verifizierung abgerechnet wird.

| Prüfung | Was die Person tut | Listenpreis |
| - | - | - |
| Liveness | Nimmt ein Selfie auf, das auf Liveness geprüft wird. | \$0.10 |
| Selfie-Anmeldung | Nimmt ein Selfie auf, das Didit mit dem bereits für die Person gespeicherten Gesicht abgleicht. | \$0.10 |
| Vollständige Ausweisprüfung | Scannt ein Ausweisdokument und nimmt ein Selfie auf: Dokument, Liveness und Gesichtsabgleich. | \$0.33 |

Didit führt jede Prüfung mit seinem Standard-Workflow aus oder mit einem eigenen Workflow, den Sie für diese Prüfung auswählen.
Alle Verifizierungspreise finden Sie unter [Preise](https://docs.didit.me/de/getting-started/pricing.md).

## Bei der Registrierung

Wählen Sie die Stufe, die eine Person bestehen muss, bevor ihr Konto erstellt wird:

| Stufe | Wert | Bedeutung |
| - | - | - |
| Keine Verifizierung | `none` | Jeder mit einer E-Mail-Adresse, einer Telefonnummer oder einem Passkey kann sich registrieren. Der Standard. |
| Liveness | `liveness` | Eine echte Person registriert sich: ein Selfie, das auf Liveness geprüft wird. |
| Full ID | `full_id` | Dokument, Liveness-Erkennung und Gesichtsabgleich, bevor das Konto existiert. |

Eine neue Stufe gilt nur für Personen, die sich ab diesem Zeitpunkt registrieren, niemals für bestehende Konten.

Auf den gehosteten Seiten führt Didit die Person während der Registrierung durch die Prüfung.
Auf Ihren eigenen Bildschirmen antwortet der Registrierungsaufruf mit `verification_required` und einer `verification_url`, die 30 Minuten gültig ist: Leiten Sie die Person dorthin weiter.
Didit stellt den Anmeldecode erst aus, nachdem die Prüfung genehmigt wurde.

## Step-up vor sensiblen Aktionen

Ein Step-up fordert die Person zur erneuten Verifizierung auf, aber nur, wenn eine Aktion riskant genug ist.
Sie aktivieren die Regeln, und Ihre App fragt Didit vor jeder sensiblen Aktion, ob eine Regel greift.

![Ein Telefon zeigt einen Step-up, der die Person bittet, mit einem Selfie zu bestätigen, dass sie es ist](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/step-up-preview.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=dd5087d0ba5f20b49bbd4252149ef8ca)

Was eine Person sieht, wenn ein Step-up ein Selfie verlangt.

| Regel | Wird ausgelöst, wenn | Standardprüfung |
| - | - | - |
| `payout` | Eine Auszahlung oder Überweisung liegt über Ihrem Schwellenwert, zum Beispiel 500 in Ihrer Währung. Eine Auszahlung in einer anderen Währung wird immer geprüft. | Selfie-Login |
| `device` | Eine Auszahlung erfolgt in einer Sitzung auf einem Gerät, von dem keine früheren Sitzungen der Person stammen. | Selfie-Login |
| `bank` | Die Person fügt ein Bankkonto hinzu oder ändert es. | Full ID |
| `contact` | Die Person ändert ihre E-Mail-Adresse oder Telefonnummer. | Liveness-Erkennung |

Sie können die Prüfung jeder Regel auf Liveness-Erkennung, Selfie-Login oder Full ID ändern.
Greifen mehrere Regeln, fordert Didit die stärkste Prüfung an.
Hat Didit für die Person noch kein Gesicht gespeichert, wird aus einem Selfie-Login eine Full-ID-Prüfung.

### Step-up anfordern

Ihre App ruft `POST {issuer}/step-up/` mit dem Access-Token der Person auf oder verwendet die Methode `stepUp()` der SDKs:

```bash theme={null}
curl --fail-with-body "${DIDIT_AUTH_ISSUER}/step-up/" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "payout", "amount": "900.00", "currency": "USD", "return_to": "https://app.example.com/payouts/confirm"}'
```

| Feld | Regel |
| - | - |
| `action` | `payout`, `bank` oder `contact`. Eine Auszahlung wendet außerdem die Regel `device` an. |
| `amount` | Pflicht bei `payout`, mit bis zu zwei Nachkommastellen. |
| `currency` | ISO-4217-Code. Standardmäßig die Währung Ihrer Auszahlungsregel. |
| `return_to` | Wohin die Person nach der Verifizierung zurückkehrt. Greift eine Regel, muss es eine Ihrer registrierten [Weiterleitungs-URLs](https://docs.didit.me/de/authentication/overview.md#weiterleitungs-urls) sein. |

* `200 {"required": false}`: Keine Regel greift, Sie können fortfahren.
* `201` mit `verification_url`: Leiten Sie die Person dorthin weiter. Der Step-up bleibt 30 Minuten offen (`expires_in: 1800`).

### Ergebnis im Backend auslesen

Die Person kehrt zu `return_to` zurück, wobei `step_up=<id>&status=approved` angehängt wird. Diese Query-Parameter belegen jedoch nichts.
Ihr Backend liest den Step-up mit `GET {issuer}/step-up/{step_up_id}/` und einem Access-Token derselben Sitzung aus und handelt nur, wenn `status` den Wert `approved` hat.

| Status | Bedeutung |
| - | - |
| `pending` | Die Person hat die Prüfung noch nicht abgeschlossen. |
| `approved` | Die Person hat die Prüfung bestanden. Fahren Sie mit der Aktion fort. |
| `review` | Die Prüfung wartet auf die Durchsicht durch Ihr Team. |
| `declined` | Die Person hat die Prüfung nicht bestanden. Der Status ist nicht endgültig, solange `verification_url` noch funktioniert: Die Person kann es erneut versuchen, und der Step-up kehrt zu `pending` zurück. |
| `expired` | Die 30 Minuten sind abgelaufen. Erstellen Sie einen neuen Step-up. |
| `superseded` | Eine andere Prüfung hat sie ersetzt, oder das Ergebnis gehörte nicht zu diesem Step-up. Erstellen Sie einen neuen. |

Ein Step-up gibt im Fehlerfall nie frei: Ist die Verifizierung nicht verfügbar, bleibt die Aktion blockiert.
Die Schnellstarts für [JavaScript](https://docs.didit.me/de/authentication/quickstarts/javascript.md#step-up-und-erneute-authentifizierung), [Next.js](https://docs.didit.me/de/authentication/quickstarts/nextjs.md#step-up-vor-sensiblen-aktionen) und [iOS](https://docs.didit.me/de/authentication/quickstarts/ios.md#zusätzliche-prüfung-vor-sensiblen-aktionen) zeigen die SDK-Seite, und die [API-Referenz](https://docs.didit.me/de/authentication/api-reference/create-step-up.md) enthält den vollständigen Vertrag.

## Was Ihre App erhält

Wählen Sie aus, welche verifizierten Claims in die Tokens der Person aufgenommen werden:

| Claim | Wert |
| - | - |
| `over_18`, `over_21` | Ob die Person mindestens 18 bzw. 21 Jahre alt ist, auf Grundlage des verifizierten Geburtsdatums. |
| `given_name`, `family_name` | Der verifizierte Vor- und Nachname. |
| `birthdate` | Das Geburtsdatum aus dem Dokument, `YYYY-MM-DD`. |
| `nationality` | ISO-3166-1-Alpha-2-Code. |
| `country` | ISO-3166-1-Alpha-2-Code des Landes des Dokuments. |
| `document_verified` | Ob ein Ausweisdokument verifiziert wurde. |
| `liveness` | Ob eine Liveness-Prüfung bestanden wurde. |

Das Access-Token und das ID-Token enthalten sie in `verified`, zusammen mit `level`, der höchsten Stufe, die die Person bestanden hat: `liveness`, `liveness_face_match` oder `full_id`.
Es ist `{}`, wenn die Person keine Stufe bestanden hat, und `GET /session/` gibt stattdessen `null` zurück.

```json theme={null}
{
  "verified": {
    "level": "full_id",
    "over_18": true,
    "given_name": "Alex",
    "country": "ES"
  }
}
```

* Eine während einer Sitzung genehmigte Prüfung gelangt beim nächsten Refresh, innerhalb von 5 Minuten, in die Tokens.
* Wer das Token besitzt, kann diese Claims lesen, auch Ihr Frontend. Wählen Sie daher nur die persönlichen Claims aus, die Ihre App benötigt.
* Ihre App erhält Claims, niemals das Dokument, das Selfie oder die Gesichtsdaten.

## Einrichtung über die API

`GET` und `PATCH` an `verified/` in der [API zur Authentifizierungsverwaltung](https://docs.didit.me/de/authentication/set-up-by-api.md) Ihrer Anwendung lesen und ändern dieselben Einstellungen wie die Konsole:

```bash theme={null}
curl --fail-with-body --request PATCH "${MANAGEMENT_BASE}verified/" \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "signup_level": "liveness",
    "rules": [
      {"rule": "payout", "enabled": true, "method": "selfie", "threshold": "500.00", "currency": "USD"},
      {"rule": "bank", "enabled": true, "method": "full_id"}
    ],
    "claims": ["over_18", "given_name", "country"]
  }'
```

| Feld | Werte |
| - | - |
| `signup_level` | `none`, `liveness` oder `full_id`. |
| `rules` | Ein Eintrag pro geänderter Regel: `rule` (`payout`, `device`, `bank` oder `contact`), `enabled`, `method` (`liveness`, `selfie` oder `full_id`) und nur bei `payout` `threshold` und `currency`. |
| `claims` | Die Claims, die in Tokens aufgenommen werden sollen, aus der obigen Tabelle. |
| `workflows` | Optional: Ihre eigene Workflow-ID für `liveness`, `selfie` oder `full_id` oder `null` für den Standard-Workflow von Didit. |

Eine Regel, die Sie weglassen, behält ihre aktuellen Einstellungen bei.


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