Ajoutez Checkify à votre site Web avec un Pass ID et un type de demande. Aucune configuration manuelle du lanceur n'est requise.
Dans l'application Checkify ou le tableau de bord de l'entreprise, créez un site numérique et enregistrez le domaine sur lequel votre intégration sera exécutée. Checkify provisionne automatiquement un Pass par site (par exemple
chk_live_...).
Pour les tests sandbox, utilisez un Pass de test (
chk_test_...)
provenant d'un site d'environnement de test.
Collez-le dans votre page. Remplacez
YOUR_PASS_ID
et choisissez un type de demande.
<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>
Pour les formulaires de connexion, d'inscription, de paiement ou de contact, laissez le SDK gérer le bouton, le champ de jeton caché et l'état de soumission.
<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>
Le navigateur ne reçoit qu'un jeton. Vérifiez toujours le côté serveur avant d'autoriser l'action protégée.
Utilisez la clé API de votre site et appelez
POST /v1/qr/results/verify
avec le
request_id
du champ caché (les anciennes intégrations peuvent toujours soumettre le jeton de sondage).
Voir le
guide de vérification du serveur.
Pour plus d'informations sur les événements du navigateur et les URL de retour, consultez la documentation.
référence intégrée APIpour les événements et la gestion des URL de retour.
| Type de demande | Revendication du serveur (revendications_obligatoires) | Utilisation typique |
|---|---|---|
human | vérifié par un humain | Réduction des robots/spam |
age_over_13 | âge_plus_13 | Contenu réservé aux 13 ans et plus ou contrôles de type COPPA |
age_over_16 | âge_plus_16 | Contenu réservé aux adultes (16+) ou soumis à des règles d'âge régionales |
age_over_18 | âge_plus_18 | 18+ contenus ou paiement |
age_over_21 | plus de 21 ans | 21+ produits (alcool américain, etc.) |
age_over_25 | plus de 25 ans | Seuils d'âge plus élevés |
Utilisez ces types de requêtes dans votre intégration (data-checkify-request ou Checkify.bindForm). Sur votre serveur, vérifiez la validité de la revendication correspondante dans required_claims.
L'intégration ne démarre qu'à partir des domaines enregistrés sur votre site Checkify. La vérification facultative DNS/méta/fichier augmente l'assurance commerciale mais n'est pas requise pour que l'intégration fonctionne sur un domaine enregistré.