Poproś o dowód
W aplikacji wymagane są dowody wymagane do podjęcia działania — na przykład ukończone 18 lat lub weryfikacja przez człowieka.
CHECKIFY DLA DEWELOPERÓW
Dodaj weryfikację wieku, tożsamości i osoby za pomocą narzędzi JavaScript firmy Checkify, weryfikacji serwera API i obsługiwanych wtyczek platformy. Poproś o dowód, którego potrzebuje Twoja aplikacja — Checkify zajmie się procesem weryfikacji.
MODEL INTEGRACJI
Twoja aplikacja wymaga dowodu. Checkify przeprowadza ścieżkę klienta. Otrzymujesz wynik i decydujesz, co dalej.
W aplikacji wymagane są dowody wymagane do podjęcia działania — na przykład ukończone 18 lat lub weryfikacja przez człowieka.
Checkify ustala, czy istnieją wystarczające dowody, czy też klient musi przeprowadzić dodatkową weryfikację.
Twój serwer potwierdza wynik i zezwala, blokuje lub kontynuuje chronioną akcję.
PRAWDZIWY API
Po zakończeniu sesji Pass przez klienta, system weryfikuje request_id za pomocą klucza site API. Nigdy nie umieszczaj klucza site API w kodzie przeglądarki.
Wniosek
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
}
Odpowiedź
{
"success": true,
"status": "completed",
"approved_claims": {
"age_over_18": true
}
}
Przeglądarka lub wtyczka przechowuje request_id (często jako checkify_token). Twój serwer jest autoryzowany — potwierdź approved_claims przed zezwoleniem na działanie.
O CO MOŻESZ POPROSIĆ
Zmień typ wniosku lub wymagane roszczenia dla każdej podróży — bez konieczności ponownego tworzenia infrastruktury weryfikacyjnej.
Poproś o podanie progu wiekowego, np. powyżej 13, 16, 18 lub 25 lat.
age_over_18Upewnij się, że do wypełniania formularzy, logowania i kontroli nadużyć jest obecna prawdziwa osoba.
human_verifiedZłóż wniosek o poziom zapewnienia odpowiedni do ryzyka — od podstawowego do wysokiego poziomu zapewnienia.
basic → highAssurancePoziomy bezpieczeństwa i konkretne opcje dowodowe zależą od podróży, urządzenia i skonfigurowanej polityki. Nazwy roszczeń można znaleźć w przewodniku weryfikacji serwera.
JAK INTEGRUJESZ
Zacznij od ścieżki, która odpowiada Twojemu stosowi. Wszystkie ścieżki produkcyjne korzystają z tego samego modelu dowodowego.
WordPress, WooCommerce i Joomla / J2Commerce dla popularnych CMS-ów i bramek realizacji transakcji.
Przewodnik WordPress →Osadzanie i bindForm w CDN dla niestandardowych witryn internetowych. Uruchamia sesje Pass i zapisuje token w formularzu.
Osadź dokumenty →Potwierdź wyniki poleceniem POST /v1/qr/results/verify i kluczem witryny API (csk_).
Weryfikacja serwera →Podróże między miejscami i urządzeniami z wykorzystaniem funkcji Pass i przekazania QR.
Przewodnik dla personelu fizycznego →Shopify i Wix znajdują się na liście oczekujących / zostaną wkrótce udostępnione i nie są tutaj wymienione jako integracje z produkcją na żywo.
Referencje
Checkify używa dwóch różnych danych uwierzytelniających. Użycie niewłaściwego w niewłaściwym miejscu to najczęstszy błąd integracji.
Osadzanie w przeglądarce, WordPress, Joomla — tylko front-end.
Weryfikacja zaplecza API — tylko serwer, nigdy w JavaScript.
DOSTARCZANIE WYNIKÓW
W przypadku standardowych procesów na stronie internetowej i w procesie realizacji zamówienia, zweryfikuj request_id na serwerze po wysłaniu chronionej akcji. Opcjonalne sprawdzanie statusu jest dostępne dla niestandardowych interfejsów użytkownika.
Twoja strona lub wtyczka rozpoczyna żądanie Checkify Pass powiązane z Twoją witryną.
Klient dokonuje weryfikacji lub zatwierdzenia w aplikacji Checkify.
Wywołaj punkt końcowy weryfikacji, sprawdź zatwierdzone oświadczenia, a następnie zezwól lub zablokuj.
Webhooki weryfikacyjne ogólnego przeznaczenia nie są obecnie wymagane do standardowych integracji. Webhooki wychodzące partnerów (na przykład GoHighLevel) są konfigurowane osobno w panelu biznesowym.
DOKUMENTACJA
Skorzystaj z tych przewodników, aby poznać poziom wdrożenia. Ta strona koncentruje się na modelu integracji.
Osadź przepustkę i powiąż formularz na potrzeby pierwszej chronionej akcji.
Otwórz szybki start →Punkty końcowe używane przez integracje publiczne, w tym weryfikację i status.
Otwórz dokumenty API →Atrybuty data-checkify, opcje bindForm i typy żądań.
Otwórz dokumenty do osadzenia →Klucze witryny API, wymagane_roszczenia, zużycie i podpisany_wynik.
Otwórz przewodnik po serwerze →Najpierw dodaj Checkify do jednej ścieżki — wieku, człowieka lub tożsamości — a następnie rozszerzaj ją w miarę wzrostu potrzeb związanych z produktem.