Zum Inhalt springen

Trust Center

Verifizieren Sie Ihre eigenen Nutzer: Ausweisdokumente, Gesichtsabgleich und Firmenprüfungen.

Trust Center öffnen
Am 18. November 2026 mit dem Dashboard abgeglichen

Drei Methoden tun aus Code das, was das Fenster Jemanden verifizieren tut: eine Sitzung öffnen, eine Sitzung lesen und Sitzungen auflisten. Jede handelt für das Trust Center des Kontos, dessen API-Schlüssel du verwendest.

Eine Sitzung öffnen

Rufe verify_session_create auf. Sende level (1 bis 4, Standard 2) und, wenn du möchtest, dein eigenes external_ref (höchstens 200 Zeichen). Die Antwort enthält eine session_id, eine hosted_url, die du der Person sendest, und expires_at, das 24 Stunden später liegt.

Leite deinen Nutzer auf hosted_url weiter oder sende sie ihm.

Das Ergebnis lesen

Rufe verify_session_result mit der session_id auf. Es gibt den status, dein external_ref, die Zeiten und das result zurück, sobald die Sitzung abgeschlossen ist.

curl -s https://xuda.ai/cpi/verify_session_create \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","level":2,"external_ref":"user_482"}'
const res = await fetch('https://xuda.ai/cpi/verify_session_create', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({ api_key: 'YOUR_API_KEY', level: 2, external_ref: 'user_482' }),
});
const { code, data } = await res.json();
// data.hosted_url is where you send this user next.
import requests

res = requests.post(
    'https://xuda.ai/cpi/verify_session_create',
    json={'api_key': 'YOUR_API_KEY', 'level': 2, 'external_ref': 'user_482'},
)

Was über die Sitzung entscheidet

  • Der Modus. Eine Sitzung ist ein Test, wenn der Dienst im Testmodus läuft, und live, wenn er in Live läuft. Testsitzungen sind kostenlos, werden nie gezählt und lassen sich aus dem Dashboard beenden. Live-Links lassen sich noch nicht abschließen.
  • Die Stufe. Eine Stufe über dem, was dein Tarif erlaubt, wird abgelehnt, mit dem Hinweis, welcher Tarif sie trägt. Die Anfrage wird nie stillschweigend gesenkt.
  • Über dem Kontingent. Eine Live-Sitzung über dem monatlichen Kontingent deines Tarifs wird bei Free abgelehnt, und bei einem kostenpflichtigen Tarif wird sie erstellt und als Überschreitung markiert.

Schlüssel werden unter Entwickler erstellt, und dafür brauchst du deine eigene Stufe 2.

Ablehnungen

Webhooks

Ab Starter legst du in den Trust-Center-Einstellungen eine Adresse fest, und wenn über eine Verifizierung entschieden ist, wird eine signierte Anfrage gesendet, sodass du nicht abfragen musst. Jede trägt einen Header Xuda-Event und einen Header Xuda-Signature, der aus einem Zeitstempel und einem HMAC aus Zeitstempel und Body besteht, signiert mit dem Geheimnis, das einmal in den Einstellungen angezeigt wird. Eine Zustellung, die scheitert, wird erneut versucht, bis zu fünf Versuche.

Wie findest du diese Anleitung?

Zuletzt aktualisiert am 16. November 2026