Vraag om het bewijs
Je applicatie vraagt het bewijs dat nodig is voor een actie — bijvoorbeeld ouder dan 18 of mens geverifieerd.
CHECKIFY VOOR ONTWIKKELAARS
Voeg leeftijds-, mens- en identiteitsverificatie toe via de JavaScript-tools van Checkify, de server-verify-API en ondersteunde platformplugins. Vraag het bewijs dat je applicatie nodig heeft — Checkify verzorgt de verificatiereis.
INTEGRATIEMODEL
Je applicatie vraagt om een bewijs. Checkify voert de klantreis uit. Jij ontvangt een resultaat en beslist wat er daarna gebeurt.
Je applicatie vraagt het bewijs dat nodig is voor een actie — bijvoorbeeld ouder dan 18 of mens geverifieerd.
Checkify bepaalt of er voldoende bewijs is of dat de klant aanvullende verificatie moet voltooien.
Je server bevestigt het resultaat en staat toe, blokkeert of zet de beschermde actie voort.
ECHTE API
Nadat de klant een Pass-sessie heeft voltooid, verifieert je backend de request_id met een site-API-sleutel. Zet de site-API-sleutel nooit in browsercode.
Request
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
}
Response
{
"success": true,
"status": "completed",
"approved_claims": {
"age_over_18": true
}
}
De browser of plugin bewaart een request_id (vaak als checkify_token). Je server is de autoriteit — bevestig approved_claims voordat je de actie toestaat.
WAT JE KUNT VRAGEN
Wijzig het verzoektype of de vereiste claims per reis — zonder verificatie-infrastructuur opnieuw te bouwen.
Vraag een leeftijdsdrempel zoals ouder dan 13, 16, 18 of 25.
age_over_18Stel vast dat er een echt persoon aanwezig is voor formulieren, login en misbruikcontroles.
human_verifiedVraag het assurance-niveau dat bij het risico past — van basic tot highAssurance.
basic → highAssuranceAssurance-niveaus en exacte bewijsopties hangen af van de reis, het apparaat en het geconfigureerde beleid. Zie de server-verifygids voor claimnamen.
HOE JE INTEGREERT
Begin met het pad dat bij je stack past. Alle productiepaden gebruiken hetzelfde bewijsmodel.
WordPress, WooCommerce en Joomla / J2Commerce voor gangbare CMS- en checkoutpoorten.
WordPress-gids →CDN-embed en bindForm voor aangepaste websites. Start Pass-sessies en schrijft het token in je formulier.
Embed-docs →Bevestig resultaten met POST /v1/qr/results/verify en een site-API-sleutel (csk_).
Server verify →Locatie- en apparaat-naar-apparaatreizen met Pass en QR-overdracht.
Gids voor fysiek personeel →Shopify en Wix staan op de wachtlijst / komen binnenkort en worden hier niet als live productie-integraties vermeld.
Credentials
Checkify gebruikt twee verschillende credentials. De verkeerde op de verkeerde plek gebruiken is de meest voorkomende integratiefout.
Browser-embed, WordPress, Joomla — alleen frontend.
Backend-verify-API — alleen server, nooit in JavaScript.
RESULTAATAFLEVERING
Voor standaard website- en checkoutstromen verifieer je de request_id op je server wanneer de beschermde actie wordt ingediend. Optionele statuspolling is beschikbaar voor aangepaste frontends.
Je pagina of plugin start een Checkify Pass-verzoek gebonden aan je site.
De klant verifieert of keurt goed in de Checkify-app.
Roep het verify-endpoint aan, controleer approved_claims, en sta daarna toe of blokkeer.
Algemene verificatie-webhooks zijn vandaag niet vereist voor standaardintegraties. Partner-outbound-webhooks (bijvoorbeeld GoHighLevel) worden apart geconfigureerd in het businessdashboard.
DOCUMENTATIE
Gebruik deze gidsen voor implementatiediepte. Deze pagina blijft gericht op het integratiemodel.
Embed een Pass en bind een formulier voor je eerste beschermde actie.
Open quickstart →Endpoints die door openbare integraties worden gebruikt, inclusief verify en status.
Open API-docs →data-checkify-attributen, bindForm-opties en verzoektypes.
Open embed-docs →Site-API-sleutels, required_claims, consume en signed_result.
Open servergids →Voeg Checkify eerst toe aan één reis — leeftijd, mens of identiteit — en breid uit naarmate je product groeit.