Checkify
JavaScript SDK — готов к работе

Сборка Проверить в ваше собственное приложение или на веб-сайт.

Один пропуск Checkify для каждого сайта. Ваша страница выбирает доказательство — человек, возраст 18 или 25 лет — когда пользователь начинает проверку. Вставьте фрагмент для внедрения и проверьте результат на своем сервере.

Быстрый старт 
<script src="https://checkify.me/sdk/v1/checkify.min.js"></script>
<div data-checkify-pass="chk_live_YOUR_PASS_ID" data-checkify-request="human"></div>

Создайте цифровой сайт на панели управления бизнесом, скопируйте свой Pass ID, зарегистрируйте домены, на которых будет работать встраивание, а затем вставьте фрагмент ниже. Дополнительный DNS, метатег или проверка файла повышают надежность, но не являются обязательными для работы встраивания.

Краткое руководство для разработчиков Бизнес-панель Интеграция WordPress

Нужна помощь? Отправьте электронное письмо по адресу support@checkify.me или откройте вкладку «Проверить пропуски» после входа в систему, чтобы скопировать свой идентификатор Pass ID и фрагмент интеграции.

Процесс интеграции
Сайт → Pass ID → SDK → Проверка сервера
Жить
Процесс разработки
Создать цифровой сайт Жить
Копировать идентификатор пропуска Жить
Добавить встраивание SDK Жить
Подтвердите на своем сервере Жить
1
Создать сайт
2
Добавить SDK
3
Проверять
Встроить
SDK в прямом эфире
Проверять
API в реальном времени
Обзор

Один пропуск на сайт. Тип запроса на вашей странице.

Установите флажок, чтобы при создании цифрового сайта автоматически предоставлялся один многоразовый идентификатор Pass ID. Вы сохраняете один и тот же идентификатор Pass ID везде на этом сайте — при оформлении заказа, входе в систему, регистрации — и устанавливаете data-checkify-request там, где требуется каждое подтверждение. Нет индивидуальной настройки лаунчера.

1

Встраивание JavaScript

Автоматическое монтирование виджетов или bindForm для форм входа, регистрации, оформления заказа и контактов. SDK обрабатывает кнопку, скрытое поле checkify_token и состояние отправки.

Доступно сейчас
2

Проверка сервера

Вызовите POST /v1/qr/results/verify, используя ключ API вашего сайта и request_id из скрытого поля. Никогда не доверяйте только браузеру — проверяйте его перед регистрацией, оформлением заказа или сбросом пароля.

Доступно сейчас
3

WordPress и WooCommerce

Установите плагин Checkify, вставьте свой Pass ID и выберите проверку человека или возраста на страницах, которые вы защищаете. Та же однопроходная модель, что и на пользовательских сайтах.

Доступно сейчас
Однопроходная модель

Как билеты Checkify работают сегодня

Сайты, пропуска и запросы на подтверждение — это отдельные уровни. Это упрощает работу с плагинами WordPress, WooCommerce и пользовательскими сайтами: один идентификатор для копирования, множество мест для его использования.

1

1. Создайте сайт

Зарегистрируйте свой бизнес, добавьте цифровой сайт и перечислите разрешенные домены (например, example.com и www.example.com). Каждый сайт получает ровно один пропуск Checkify.

2

2. Скопируйте один идентификатор доступа.

Найдите свой идентификатор Pass ID на бизнес-панели в разделе Checkify Passes или Developer. Используйте один и тот же идентификатор на своем веб-сайте, в плагине или при интеграции с серверной частью — он не меняется при переключении типов доказательства.

3

3. Выберите тип запроса в коде.

Установите для data-checkify-request значение человека, age_over_18 или age_over_25 при каждом внедрении или вызове bindForm. Человеческие чеки обычно бесплатны; проверки возраста потребляют кредиты при одобрении.

Типы запросов

data-checkify-request Типичное использование
человек Замена CAPTCHA, сокращение количества ботов, простая проверка человеком
age_over_18 Оформление заказа для лиц 18+, ограниченный контент, регистрация с ограничением по возрасту
age_over_25 Задача 25: более высокие возрастные пороги
Что доступно

Варианты интеграции

Конечная точка внедрения JavaScript и проверки сервера уже запущена в производство. Используйте бизнес-панель для создания сайтов, копирования идентификаторов Pass и выдачи ключей API сайта.

Передача мобильных приложений и упаковка npm находятся в планах. Все, что вам нужно для интеграции веб-сайтов, сегодня работает со сценарием CDN и API проверки REST.

Доступно сегодня

JS
Веб-SDK JavaScript
Сценарий CDN для веб-сайтов, форм, оформления заказа и пользовательских потоков. Идентификатор пропуска + тип запроса для каждого внедрения.
Доступно сейчас
API
API проверки сервера
POST /v1/qr/results/verify с авторизацией: носитель YOUR_SITE_API_KEY. Документация и примеры кода в руководствах для разработчиков.
Доступно сейчас
App
Интеграция мобильного приложения
Запустите Checkify из собственных приложений через QR или глубокую ссылку. Скоро появятся руководство и пакет SDK.
Вскоре

Устаревшие идентификаторы лаунчера устарели. Используйте Pass ID + тип запроса для всех новых интеграций.

Как это работает

Сквозная интеграция

Четыре шага от настройки сайта до подтвержденного пользователя на вашем сервере. Идентификатор Pass остается постоянным; в зависимости от варианта использования изменяются только тип запроса и сервер, проверяющий утверждения.

Шаг 1

Создайте сайт и скопируйте свой Pass ID

Войдите в бизнес-панель, откройте Сайты и создайте цифровой сайт с разрешенными доменами. Checkify автоматически создает один пропуск. Откройте Checkify Passes, чтобы скопировать идентификатор Pass (chk_live_…) или получить готовый фрагмент.

Один проход, множество применений

Тот же идентификатор Pass ID при входе в систему (человек), оформлении заказа (age_over_18) и на страницах только для сотрудников (человек) — меняйте только data-checkify-request для каждой вставки.

Доступно сейчас: Сайты + Проверки пропусков на панели управления.
Создайте сайт и скопируйте Checkify Pass ID

Шаг 2

Добавьте вставку на свою страницу

Загрузите SDK с сайта checkify.me и смонтируйте виджет Pass или используйте Checkify.bindForm для форм. Замените YOUR_PASS_ID и установите тип запроса для этой страницы или действия.

Минимальная вставка
<script src="https://checkify.me/sdk/v1/checkify.min.js"></script>
<div data-checkify-pass="chk_live_YOUR_PASS_ID" data-checkify-request="human"></div>
Доступно сейчас: встраивание JavaScript + bindForm

Пример привязки формы

<script src="https://checkify.me/sdk/v1/checkify.min.js"></script>

<div
  data-checkify-pass="chk_live_YOUR_PASS_ID"
  data-checkify-request="age_over_18"
  data-checkify-text="Verify with Checkify"
></div>

См. встроить ссылку на API для configure(), событий и обработки URL-адресов возврата.

Шаг 3

Пользователь завершает проверку

Когда пользователь нажимает «Подтвердить», Checkify открывает поток подтверждения (в браузере или через приложение Checkify на мобильном телефоне). В случае успеха SDK записывает request_id в ваше скрытое поле checkify_token, чтобы ваш сервер мог его проверить.

✓ Один и тот же идентификатор пропуска для каждого типа доказательства на этом сайте.
✓ Человек, возраст 18 и возраст 25 выбраны в параметрах HTML или bindForm, а не в настройках Pass.
✓ Домен должен соответствовать списку разрешенных доменов сайта.
Доступно сейчас: Pass Start + передача приложения

Параметры запуска

Встроенная кнопка
Вставьте виджет или bindForm на свою страницу.
QR/магическая ссылка
Физические местоположения и личные потоки через панель управления.
Мобильная передача обслуживания
Пользователь завершает подтверждение в приложении Checkify и возвращается на ваш сайт.

Шаг 4

Подтвердите на своем сервере

Прочтите request_id из формы POST, затем вызовите конечную точку проверки с помощью ключа API вашего сайта. Прежде чем разрешить защищенное действие, проверьте утвержденные утверждения (human_verified, age_over_18 и т. д.).

Проверить запрос (сервер)
POST https://checkify.me/v1/qr/results/verify
Authorization: Bearer YOUR_SITE_API_KEY

{
  "request_id": "uuid-from-checkify_token-field",
  "required_claims": ["human_verified"],
  "consume": true
}
Доступно сейчас: POST /v1/qr/results/verify

После успешной проверки

Внешний интерфейс
Включите отправку, продолжение оформления заказа или отображение успеха — только после того, как ваш сервер подтвердит проверку.
Бэкэнд
Используйте require_claims и consume: true для одноразовых действий, таких как регистрация или сброс пароля.
Ваша политика
Разрешите оформление заказа, разблокируйте контент, создайте учетную запись или одобрите действия персонала на основе утвержденных заявок.

Готовность к производству для веб-сайтов

Создайте сайт, скопируйте один идентификатор Pass, встройте SDK и подтвердите его с помощью ключа API сайта. WordPress и WooCommerce используют одну и ту же модель.

Используйте сейчас

Встраивание JavaScript, bindForm, API проверки сервера, ключи API сайта, плагин WordPress, бизнес-панель.

Дорожная карта

пакет npm, веб-перехватчики, доставка подписанных веб-перехватчиков, руководства по собственному мобильному SDK.

Начать интеграцию

Создайте свой сайт на панели управления бизнесом, скопируйте свой Pass ID и следуйте краткому руководству для разработчиков. Сайты WordPress могут использовать плагин с тем же Pass ID.

Краткое руководство для разработчиков Бизнес-панель Интеграция WordPress