Checkify

CHECKIFY FÜR ENTWICKLER

Eine Frage stellen. Holen Sie sich einen vertrauenswürdigen Beweis.

Verbinden Sie Ihre Website, kopieren Sie Ihre Checkify Pass-ID, wählen Sie aus, was Sie überprüfen möchten, und fügen Sie Checkify in die Anmeldung, den Checkout, Kommentare, Kontaktformulare oder Ihren eigenen benutzerdefinierten Ablauf ein.

INTEGRATIONSMODELL

Ein Verifizierungsmodell.

Ihre Bewerbung verlangt einen Nachweis. Checkify führt die Customer Journey durch. Sie erhalten ein Ergebnis und entscheiden, was als nächstes passiert.

ANFRAGE

Fordern Sie den Beweis an

In Ihrer Bewerbung wird der für eine Aktion erforderliche Nachweis verlangt – zum Beispiel über 18 Jahre alt oder durch einen Menschen verifiziert.

VERIFIZIEREN

Kunde verifiziert

Checkify ermittelt, ob ein ausreichender Nachweis vorliegt oder ob der Kunde eine zusätzliche Verifizierung durchführen muss.

ERGEBNIS

Fahren Sie in Ihrer App fort

Ihr Server bestätigt das Ergebnis und erlaubt, blockiert oder setzt die geschützte Aktion fort.

ECHTE API

Sehen Sie sich die gesamte Integration an.

Nachdem der Kunde eine Pass-Sitzung abgeschlossen hat, überprüft Ihr Backend die request_id mit einem Site-API-Schlüssel. Fügen Sie niemals den Site-API-Schlüssel in den Browsercode ein.

Anfrage

POST /v1/qr/results/verify
Authorization: Bearer YOUR_SITE_API_KEY
Content-Type: application/json

{
  "request_id": "56a57761-ff5b-42f0-9c97-6c13e223e017",
  "required_claims": ["age_over_18"],
  "consume": true
}

Antwort

{
  "success": true,
  "status": "completed",
  "approved_claims": {
    "age_over_18": true
  }
}

Der Browser oder das Plugin speichert eine request_id (häufig als checkify_token). Ihr Server ist die Autorität – bestätigen Sie „approved_claims“, bevor Sie die Aktion zulassen.

WAS SIE ANFRAGEN KÖNNEN

Eine Integration. Verschiedene Beweise.

Ändern Sie den Anfragetyp oder die erforderlichen Ansprüche für jede Fahrt – ohne die Verifizierungsinfrastruktur neu aufbauen zu müssen.

Alter

Fordern Sie eine Altersgrenze an, z. B. über 13, 16, 18 oder 25.

age_over_18

Menschlich

Stellen Sie sicher, dass eine reale Person für Formulare, Anmeldungen und Missbrauchskontrollen anwesend ist.

human_verified

Identitätssicherung

Fordern Sie die dem Risiko entsprechende Sicherheitsstufe an – von „Basic“ bis „HighAssurance“.

basic → highAssurance

Die Sicherheitsstufen und genauen Nachweisoptionen hängen von der Reise, dem Gerät und der konfigurierten Richtlinie ab. Die Anspruchsnamen finden Sie im Leitfaden zur Serverüberprüfung.

WIE SIE INTEGRIEREN

Vom Plugin zur API.

Beginnen Sie mit dem Pfad, der Ihrem Stapel entspricht. Alle Produktionspfade verwenden dasselbe Proof-Modell.

Plugins

WordPress, WooCommerce und Joomla/J2Commerce für gängige CMS und Checkout-Gates.

WordPress-Anleitung →

JavaScript

CDN-Einbettung und BindForm für benutzerdefinierte Websites. Startet Pass-Sitzungen und schreibt das Token in Ihr Formular.

Dokumente einbetten →

Server-API

Bestätigen Sie die Ergebnisse mit POST /v1/qr/results/verify und einem Site-API-Schlüssel (csk_).

Serverüberprüfung →

Shopify und Wix stehen auf der Warteliste bzw. sind bald verfügbar und werden hier nicht als Live-Produktionsintegrationen aufgeführt.

Anmeldeinformationen

Pass-ID vs. Website API-Schlüssel

Checkify verwendet zwei verschiedene Anmeldeinformationen. Die Verwendung der falschen Anmeldeinformationen am falschen Ort ist der häufigste Integrationsfehler.

Passwort-ID

Browser embed, WordPress, Joomla — frontend only

Site API key (csk_…)

Backend verify API — server only, never in JavaScript

ERGEBNISLIEFERUNG

Erfahren Sie, wann die Verifizierung abgeschlossen ist.

Überprüfen Sie für standardmäßige Website- und Checkout-Abläufe die request_id auf Ihrem Server, wenn die geschützte Aktion übermittelt wird. Für benutzerdefinierte Frontends ist eine optionale Statusabfrage verfügbar.

1

Die Pass-Sitzung beginnt

Ihre Seite oder Ihr Plugin startet eine Checkify Pass-Anfrage, die an Ihre Website gebunden ist.

2

Kunde vervollständigt

Der Kunde verifiziert oder genehmigt in der Checkify-App.

3

Ihr Server bestätigt dies

Rufen Sie den Verifizierungsendpunkt auf, prüfen Sie „approved_claims“ und erlauben oder blockieren Sie dann.

Heutzutage sind für Standardintegrationen keine allgemeinen Verifizierungs-Webhooks erforderlich. Ausgehende Partner-Webhooks (z. B. GoHighLevel) werden separat im Business-Dashboard konfiguriert.

DOKUMENTATION

Wo das Detail lebt.

Nutzen Sie diese Leitfäden für die Tiefe der Implementierung. Diese Seite konzentriert sich weiterhin auf das Integrationsmodell.

Schnellstart

Betten Sie einen Pass ein und binden Sie ein Formular für Ihre erste geschützte Aktion.

Schnellstart öffnen →

API-Referenz

Von öffentlichen Integrationen verwendete Endpunkte, einschließlich Überprüfung und Status.

API-Dokumente öffnen →

Serverüberprüfung

Site-API-Schlüssel, „required_claims“, „consume“ und „signed_result“.

Serverhandbuch öffnen →

Stellen Sie Ihre erste Proof-Anfrage.

Fügen Sie Checkify zunächst einer Journey hinzu – Alter, Mensch oder Identität – und erweitern Sie es dann, wenn Ihre Produktanforderungen wachsen.