Checkify
JavaScript SDK v1.0.4

Démarrage rapide de 5 minutes

Ajoutez Checkify à votre site Web avec un Pass ID et un type de demande. Aucune configuration manuelle du lanceur n'est requise.

1. Créez un site et copiez votre Pass ID

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.

2. Ajoutez l'extrait d'intégration

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>

3. Lier un formulaire (facultatif)

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>

4. Vérifiez sur votre backend

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.

Types de demande

Type de demande Revendication du serveur (revendications_obligatoires) Utilisation typique
humanvérifié par un humainRéduction des robots/spam
age_over_13âge_plus_13Contenu réservé aux 13 ans et plus ou contrôles de type COPPA
age_over_16âge_plus_16Contenu réservé aux adultes (16+) ou soumis à des règles d'âge régionales
age_over_18âge_plus_1818+ contenus ou paiement
age_over_21plus de 21 ans21+ produits (alcool américain, etc.)
age_over_25plus de 25 ansSeuils 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.

Liaison de domaine

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é.