Tovanix

API für Verifizierung und Transaktionsrisiko

Mit einem API-Schlüssel der Plattform starten Sie aus Ihren eigenen Systemen heraus Identitätsprüfungen von Personen (KYC), Unternehmensprüfungen (KYB), Transaktionsüberwachungen und Prüfungen von Wallet-Adressen und fragen Prüfeinträge ab. Die offene API und die Konsole nutzen denselben Prüfablauf: dieselben Preise und dieselben Regeln für Ergebnisse, Erstattungen und Abgleich.

Klicken Sie zuerst in der Konsole unter „Verifizierung und Transaktionsrisiko“ auf „Aktivieren“, erstellen Sie dann unter „API-Verwaltung“ einen Schlüssel und erteilen Sie ihm die Berechtigungen „Verifizierung und Risiko“: verification.read zum Abfragen von Preisen und Einträgen, verification.write zum Starten von Prüfungen. Jede Prüfung wird vom Kontoguthaben abgebucht.

Endpunkte

GET /api/v1/verification/info: Gibt zurück, ob der Dienst für Ihr Konto aktiviert ist, ob jede der vier Prüfungsarten verfügbar ist und zu welchem Preis (USD) sowie welche Netzwerke und Vermögenswerte für Transaktionsüberwachung und Wallet-Prüfung zur Auswahl stehen. Nicht verfügbare Arten haben keinen Preis.
POST /api/v1/verification/checks: Startet eine Prüfung; Abbuchung und Anlegen des Eintrags erfolgen in derselben Anfrage. Identitätsprüfungen liefern eine handoff_url, die Sie an die geprüfte Person senden; Transaktionsüberwachung und Wallet-Prüfung liefern das Ergebnis in der Regel direkt.
GET /api/v1/verification/checks: Die Liste ist nach Startzeit absteigend sortiert und lässt sich nach kind, status, verdict und keyword (Referenz, Adresse oder Abrechnungsnummer) filtern; geblättert wird mit page und page_size (höchstens 100 pro Seite). Die Einzelabfrage enthält handoff_url, solange die Sitzung noch bei der geprüften Person liegt. Beim Aktualisieren wird das Ergebnis erneut beim Anbieter abgerufen (Wallet-Prüfungen lassen sich nicht aktualisieren; eine erneute Prüfung wird erneut berechnet).

Eine Wiederholung mit demselben idempotency_key und demselben Inhalt liefert den ursprünglichen Eintrag ohne erneute Abbuchung; derselbe Schlüssel mit anderem Inhalt wird abgelehnt (400). Wird für eine Referenz mit noch nicht abgeschlossener Sitzung erneut eine Identitätsprüfung gestartet, wird diese Sitzung zurückgegeben (reused ist true), ebenfalls ohne Abbuchung.

Ergebnis-Callbacks

Hinterlegen Sie in der Konsole unter „Integrationseinstellungen“ eine https-Callback-URL und aktivieren Sie sie. Ändern sich Status oder Ergebnis eines Prüfeintrags asynchron (Identitätsprüfung abgeschlossen, Ergebnis durch manuelle Prüfung geändert, Transaktionsergebnis aktualisiert, fehlgeschlagen und erstattet), sendet die Plattform ein Ereignis per POST. Ihr eigener Startaufruf wird nicht gepusht, da die synchrone Antwort das Ergebnis bereits enthält.

Anfrage-Header: X-Tovanix-Event ist der Ereignistyp (check.updated oder ping für Tests), X-Tovanix-Delivery ist die event_id, X-Tovanix-Timestamp ist die Unix-Zeit in Sekunden und X-Tovanix-Signature ist sha256= gefolgt vom Hexadezimalwert von HMAC-SHA256(Signaturschlüssel, Zeitstempel + "." + roher Anfrageinhalt).

Eine 2xx-Antwort gilt als zugestellt. Alles andere, einschließlich Zeitüberschreitungen, wird mit Wartezeiten von 1 Minute, 5 Minuten, 15 Minuten, 1 Stunde, 3 Stunden, 6 Stunden und 12 Stunden wiederholt, insgesamt höchstens 8 Versuche; danach wird nicht mehr gesendet. Wiederholungen senden dieselbe event_id und denselben Inhalt; deduplizieren Sie daher anhand der event_id. Ereignisse können in anderer Reihenfolge eintreffen: Maßgeblich ist das Ereignis mit dem neueren data.updated_at, oder rufen Sie den Abfrage-Endpunkt für den aktuellen Stand auf. Nach dem Deaktivieren des Callbacks werden noch nicht zugestellte Ereignisse nicht mehr gesendet.

Wird geladen…