Checkify
JavaScript SDK v1.0.1

Avvio rapido di 5 minuti

Aggiungi Checkify al tuo sito web con un ID pass e un tipo di richiesta. Non è richiesta alcuna configurazione manuale del launcher.

1. Crea un sito e copia il tuo ID pass

Nell'app Checkify o nella dashboard aziendale, crea un sito digitale e registra il dominio in cui verrà eseguito il tuo incorporamento. Checkify effettua il provisioning automatico di un Pass per sito (ad esempio chk_live_...).

Per il test sandbox, utilizza un Pass di test ( chk_test_...) da un sito dell'ambiente di test.

2. Aggiungi lo snippet di incorporamento

Incollalo nella tua pagina. Sostituisci YOUR_PASS_ID e scegli una richiesta digitare.

<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. Associa un modulo (facoltativo)

Per moduli di accesso, registrazione, pagamento o contatto, lascia che SDK gestisca il pulsante, il campo token nascosto e lo stato di invio.

<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 Verifica sul tuo backend

Il browser riceve sempre un token.

Utilizza la chiave API del tuo sito e chiama POST /v1/qr/results/verify con request_id dal campo nascosto (gli incorporamenti legacy possono comunque inviare il token del sondaggio). Consultare la guida alla verifica del server. For browser events and return URLs, see the embed API referenceper eventi e gestione degli URL di ritorno.

Tipi di richiesta

Tipo di richiesta Server claim (required_claims) Uso tipico
humanhuman_verifiedBot/spam riduzione
age_over_18age_over_1818+ contenuti o checkout
age_over_21age_over_2121+ prodotti (alcool statunitensi, ecc.)
age_over_25age_over_25Soglie di età più elevate

Use these request types in your embed (data-checkify-request or Checkify.bindForm). On your server, verify with the matching claim in required_claims.

Associazione del dominio

L'incorporamento inizia solo dai domini registrati sul tuo sito Checkify. La verifica DNS/meta/file opzionale aumenta la sicurezza aziendale, ma non è necessaria affinché l'incorporamento funzioni su un dominio registrato.