Checkify
JavaScript SDK v1.0.4

5-minuten quickstart

Voeg Checkify toe aan je website met één Pass ID en een verzoektype. Geen handmatige launcher-setup nodig.

1. Maak een site aan en kopieer je Pass ID

Maak in de Checkify-app of het bedrijfsdashboard een digitale site aan en registreer het domein waar je embed draait. Checkify voorziet automatisch één Pass per site (bijvoorbeeld chk_live_...).

Voor sandbox-tests gebruik je een test-Pass ( chk_test_...) van een site in de testomgeving.

2. Voeg het embed-snippet toe

Plak dit in je pagina. Vervang YOUR_PASS_ID en kies een verzoektype.

<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. Koppel een formulier (optioneel)

Voor login, aanmelden, checkout of contactformulieren laat je de SDK de knop, het verborgen tokenveld en de submitstatus afhandelen.

<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. Verifieer op je backend

De browser ontvangt alleen een token. Verifieer altijd server-side voordat je de beschermde actie toestaat.

Gebruik je site-API-sleutel en roep POST /v1/qr/results/verify aan met de request_id uit het verborgen veld (legacy embeds kunnen nog het poll-token meesturen). Zie de server-verifygids. Voor browserevents en return-URL’s, zie de embed API-referentie voor events en return-URL-afhandeling.

Verzoektypes

Verzoektype Serverclaim (required_claims) Typisch gebruik
humanhuman_verifiedBot-/spamreductie
age_over_13age_over_1313+ content of COPPA-achtige gates
age_over_16age_over_1616+ content of regionale leeftijdsregels
age_over_18age_over_1818+ content of checkout
age_over_21age_over_2121+ producten (VS-alcohol, enz.)
age_over_25age_over_25Hogere leeftijdsdrempels

Gebruik deze verzoektypes in je embed (data-checkify-request of Checkify.bindForm). Verifieer op je server met de bijbehorende claim in required_claims.

Domeinkoppeling

De embed start alleen vanaf domeinen die op je Checkify-site zijn geregistreerd. Optionele DNS-/meta-/bestandsverificatie verhoogt de bedrijfszekerheid, maar is niet vereist om de embed op een geregistreerd domein te laten werken.