Checkify
JavaScript SDK v1.0.4

5-minutowy szybki start

Dodaj Checkify do swojej witryny za pomocą jednego identyfikatora karty i typu żądania. Nie jest wymagana ręczna konfiguracja programu uruchamiającego.

1. Utwórz witrynę i skopiuj swój identyfikator dostępu

W aplikacji Checkify lub na pulpicie biznesowym utwórz witrynę cyfrową i zarejestruj domenę, w której będzie działać osadzona treść. Checkify automatycznie udostępnia jedną przepustkę na witrynę (na przykład chk_live_...).

Do testowania w piaskownicy użyj testu Pass ( chk_test_...) ze środowiska testowego.

2. Dodaj osadzony fragment kodu

Wklej to na swoją stronę. Zastąp YOUR_PASS_ID i wybierz typ żądania.

<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. Powiąż formularz (opcjonalnie)

W przypadku formularzy logowania, rejestracji, realizacji transakcji lub kontaktu pozwól, aby SDK obsługiwał przycisk, ukryte pole tokena i stan przesyłania.

<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. Zweryfikuj swoje zaplecze

Przeglądarka otrzymuje tylko token. Zawsze weryfikuj po stronie serwera przed zezwoleniem na chronioną akcję.

Użyj klucza API swojej witryny i zadzwoń POST /v1/qr/results/verify z request_id z ukrytego pola (starsze osadzenia nadal mogą przesyłać token ankiety). Zobacz przewodnik weryfikacji serwera. Aby zapoznać się z wydarzeniami przeglądarki i adresami URL zwrotnymi, zobacz osadź odniesienie APIdla zdarzeń i obsługi zwrotnego adresu URL.

Typy żądań

Typ żądania Oświadczenie serwera (required_claims) Typowe zastosowanie
humanzweryfikowany_ludzkiRedukcja botów/spamu
age_over_13wiek_powyżej_13 latTreści powyżej 13 lat lub bramki w stylu COPPA
age_over_16wiek_powyżej_16 latTreści dla osób powyżej 16 roku życia lub regionalne zasady dotyczące wieku
age_over_18wiek_powyżej_18 latTreści 18+ lub przejdź do kasy
age_over_21wiek_powyżej_21 latProdukty 21+ (alkohol z USA itp.)
age_over_25wiek_powyżej_25 latWyższe progi wiekowe

Użyj tych typów żądań w swoim osadzeniu (data-checkify-request lub Checkify.bindForm). Na serwerze zweryfikuj je z odpowiadającym żądaniem w pliku required_claims.

Wiązanie domeny

Osadzanie rozpoczyna się tylko od domen zarejestrowanych w witrynie Checkify. Opcjonalna weryfikacja DNS/meta/plików zwiększa bezpieczeństwo biznesowe, ale nie jest wymagana do działania osadzanego elementu w zarejestrowanej domenie.