Trust Center
Verifizieren Sie Ihre eigenen Nutzer: Ausweisdokumente, Gesichtsabgleich und Firmenprüfungen.
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.
Den Link senden
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.
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.
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.