Fehlt ein Land oder eine eigene Prüfung? Sagen Sie uns, was Sie brauchen.15-Minuten-Gespräch buchen

Entwickler

Eine Person mit einem API-Aufruf prüfen.

Ihr Backend erstellt eine Sitzung, die Person verifiziert sich auf einer gehosteten Seite oder in einem eingebetteten Frame, und das Ergebnis kommt per Webhook und als signiertes Ergebnis zurück.

Die API-Referenz ist öffentlich unter app.secuveri.com/docs, ohne Anmeldung.

curl -X POST https://api.secuveri.com/v1/sessions \
  -H "x-api-key: $SECUVERI_API_KEY" \
  -H "content-type: application/json" \
  -H "Idempotency-Key: signup-1042" \
  -d '{
    "workflow_id": "wf_kyc_standard",
    "vendor_data": "customer-1042"
  }'

201Antwort

{
  "verification_id": "VRF-7KQ2M9XA",
  "status": "CREATED",
  "url": "https://verify.secuveri.com/verification/VRF-7KQ2M9XA?t=…"
}

Schnellstart

In drei Schritten live.

  1. 01

    API-Schlüssel erstellen

    Unter Einstellungen, API-Schlüssel. sk_test_ für die Sandbox, sk_live_ für Produktion. Schlüssel bleiben auf Ihrem Server.

  2. 02

    Sitzung erstellen

    POST /v1/sessions liefert einen Link. Weiterleiten, als QR-Code zeigen oder von uns per E-Mail oder SMS senden lassen.

  3. 03

    Ergebnis erhalten

    Ein signierter Webhook meldet den Abschluss. Das signierte Ergebnis enthält den Entscheid und jede Prüfung.

Einzel-APIs

Jede API auch einzeln nutzen.

Jede Prüfung gibt es auch als eigene API, ausserhalb eines Verifizierungsablaufs. Jede mit ihrem tatsächlichen Stand.

Verfügbar

Dokumentprüfung

Ausweisdokument und NFC-Chip auslesen und prüfen.

Verfügbar

Gesichtsabgleich

Zwei Gesichtsbilder vergleichen.

Verfügbar

Liveness

Prüfen, ob ein Selfie eine lebende Person zeigt.

Verfügbar

Alterseinschätzung

Das Alter anhand eines Gesichtsbilds schätzen.

Verfügbar

AML-Screening

Eine Person mit POST /v1/aml/screen gegen Sanktions- und PEP-Listen prüfen.

Verfügbar

Adressnachweis

Eine Rechnung oder einen Auszug für Ihre Prüfung auslesen.

Verfügbar

Content Credentials (C2PA)

Die Content Credentials eines Bilds mit dem secuveri C2PA Validator prüfen.

Verfügbar

Unternehmensprüfung (KYB)

Ein Unternehmen im Schweizer Handelsregister prüfen.

Ergebnisse, denen Sie vertrauen können

Webhooks und signierte Ergebnisse.

Der Webhook sagt Ihnen, dass etwas passiert ist. Das signierte Ergebnis sagt Ihnen was, prüfbar für alle mit unseren öffentlichen Schlüsseln.

  1. 01

    Ihr Backend

    POST /v1/sessions

  2. 02

    Gehosteter Ablauf

    Dokument, Liveness, Gesichtsabgleich

  3. 03

    Webhook

    secuveri-signature: HMAC-SHA256

  4. 04

    Signiertes Ergebnis

    ES256-JWS, geprüft mit /.well-known/jwks.json

  • Webhooks werden 7-mal über rund 21 Stunden wiederholt
  • Ereignis-IDs, um Duplikate zu verwerfen
  • Keine Personendaten im signierten Ergebnis

Bausteine

Was die API Ihnen bietet.

Alles, um Verifizierungen aus Ihrem eigenen Backend zu steuern.

Sessions-API

Sitzung erstellen und Link und Token erhalten. Idempotenzschlüssel, eine offene Sitzung pro Kunde, und auf Wunsch versenden wir den Link per E-Mail oder SMS.

Webhooks

Ereignisse, wenn eine Verifizierung abgeschlossen oder geprüft ist, HMAC-signiert und rund 21 Stunden lang wiederholt.

Signierte Ergebnisse

Jedes Ergebnis als ES256-JWS ohne Personendaten, prüfbar mit unseren öffentlichen Schlüsseln.

Web-Embed

Öffnen Sie den Ablauf mit einem Script-Tag als Modal oder Inline-Frame, mit QR-Übergabe ans Handy.

Sandbox

Testschlüssel und kostenlose Szenarien, die eine Sitzung mit dem gewünschten Ergebnis abschliessen.

Re-Authentifizierung

Bestätigen Sie wiederkehrende Kunden mit Selfie und Liveness, abgeglichen mit ihrer früheren Verifizierung.

Wiederverwendbare ID in swiyu (Beta)

Nach einer vollständigen Verifizierung können Personen eine secuveri Verified ID in der swiyu-App speichern und beim nächsten Mal teilen, gebunden an die Person. Beta-IDs von swiyu werden ebenfalls akzeptiert. Läuft in der öffentlichen Beta von swiyu.

Block- und Allow-Listen

Sperren oder erlauben Sie E-Mails, Telefonnummern, IP-Bereiche, Geräte, Ihre Benutzer-IDs oder Ausstellungsländer, per API oder im Dashboard.

SDKs

Bibliotheken und Embeds.

Web-Embed-Script

Verfügbar

secuveri.js öffnet den gehosteten Ablauf als Modal oder Inline-Frame und meldet den Fortschritt.

REST-API

Verfügbar

Einfaches HTTPS und JSON aus jeder Sprache, mit OpenAPI-Beschreibung.

@secuveri/web

Verfügbar

Ein typisiertes Browser-Paket für das Embed und seine Ereignisse.

@secuveri/node

Verfügbar

Ein Node.js-Client für Sitzungen, Ergebnisse und die Prüfung von Webhook-Signaturen.

iOS SDK

Demnächst

Native Erfassung und NFC-Chip-Lesen in Ihrer iPhone-App.

Android SDK

Demnächst

Native Erfassung und NFC-Chip-Lesen in Ihrer Android-App.

Kontakt

Sprechen Sie mit uns

Sagen Sie uns, was Sie prüfen möchten. Wir zeigen Ihnen, wie secuveri in Ihren Ablauf passt.

Wir antworten innerhalb eines Arbeitstages und verwenden Ihre Angaben nur für Ihre Anfrage. Siehe unsere Datenschutzerklärung.