Checkify
JavaScript SDK v1.0.1

5-minütiger Schnellstart

Fügen Sie Checkify mit einer Pass-ID und einem Anforderungstyp zu Ihrer Website hinzu. Keine manuelle Einrichtung des Launchers erforderlich.

1. Erstellen Sie eine Site und kopieren Sie Ihre Pass-ID

Erstellen Sie in der Checkify-App oder im Business-Dashboard eine digitale Site und registrieren Sie die Domain, in der Ihre Einbettung ausgeführt wird. Checkify stellt automatisch einen Pass pro Site bereit (zum Beispiel chk_live_...).

Verwenden Sie für Sandbox-Tests einen Testpass ( chk_test_...) von einer Testumgebungs-Site.

2. Fügen Sie das Einbettungs-Snippet hinzu

Fügen Sie es in Ihre Seite ein. Ersetzen Sie YOUR_PASS_ID und wählen Sie eine Anfrage aus Geben Sie ein.

<script src="https://checkify.me/sdk/v1/checkify.min.js"></script>
<div
  data-checkify-pass="YOUR_PASS_ID"
  data-checkify-request="human"
  data-checkify-text="Verify with Checkify"
></div>

3. Binden Sie ein Formular (optional)

Überlassen Sie für Anmelde-, Anmelde-, Checkout- oder Kontaktformulare die Verarbeitung der Schaltfläche, des ausgeblendeten Token-Felds und des Übermittlungsstatus.

<form id="signup-form">
  <input type="email" name="email" required>
  <input type="hidden" id="checkify_token" name="checkify_token">
  <div id="checkify-button"></div>
  <button id="submit" type="button">Create account</button>
</form>

<script src="https://checkify.me/sdk/v1/checkify.min.js"></script>
<script>
  Checkify.bindForm('#signup-form', {
    passId: 'YOUR_PASS_ID',
    requestType: 'human',
    buttonTarget: '#checkify-button',
    submitButton: '#submit',
    hiddenInput: '#checkify_token'
  });
</script>

4. Überprüfen Sie auf Ihrem Backend

Der Browser empfängt immer nur ein Token, bevor er die geschützte Aktion zulässt.

Verwenden Sie den API-Schlüssel Ihrer Website und rufen Sie POST /v1/qr/results/verify mit dem request_id aus dem versteckten Feld auf (ältere Einbettungen übermitteln möglicherweise weiterhin das Umfrage-Token). Informationen zu Ereignissen und zur Verarbeitung von Rückgabe-URLs finden Sie im Leitfaden zur Serverüberprüfung. Informationen zu Ereignissen und zur Verarbeitung von Rückgabe-URLs finden Sie im API-Referenz .

Anfragetypen

Anfragetyp Typische Verwendung
humanBot/Spam Reduzierung
age_over_1818+ Inhalte oder Checkout
age_over_2121+ Produkte (US-Alkohol usw.)
age_over_25Höhere Altersgrenzen

Domainbindung

Die Einbettung beginnt nur bei Domains, die auf Ihrer Checkify-Site registriert sind. Die optionale DNS-/Meta-/Dateiüberprüfung erhöht die Geschäftssicherheit, ist jedoch nicht erforderlich, damit die Einbettung auf einer registrierten Domäne funktioniert.