Перейти к содержимому

Глава 2 · Для бизнеса

Начало работы с GOXOST KYC

Регистрация, тестовый ключ, открытие боевого режима и выбор способа интеграции.

2 мин чтения

На этой странице
  1. 1. Регистрация
  2. 2. Тестовый ключ
  3. 3. Открытие боевого режима
  4. 4. Способ интеграции
  5. Как это работает
  6. Документация

GOXOST KYC — сервис онлайн-подтверждения личности ваших клиентов. Вы направляете клиента на проверку, он фотографирует документ и делает селфи, а ваш сервер получает решение: GREEN (одобрено), RED (отклонено) или ON_HOLD (нужна ручная проверка).

1. Регистрация

  1. Создайте аккаунт на https://kyc.goxost.net/register и войдите в панель.
  2. Сразу после регистрации доступна Тестовая среда. Настоящие проверки в ней не проводятся — результат выбираете вы сами, поэтому можно спокойно отладить всю интеграцию.

2. Тестовый ключ

  1. В панели откройте раздел API-ключи и нажмите Создать ключ.
  2. Выберите Тестовую среду. Ключ начинается с sk_test_.
  3. Сразу скопируйте ключ — он показывается только один раз. Храните его в секретных настройках сервера.

Секретный ключ — только для вашего сервера. Никогда не размещайте его в браузере, мобильном приложении или публичном репозитории.

3. Открытие боевого режима

Боевая среда (ключи sk_live_ и настоящие проверки) открывается в панели после двух шагов:

  1. Профиль компании — тип бизнеса, юридическое название, регистрационный номер (для физлиц необязателен), страна, сайт, название и описание проекта, сфера применения и цель проверки по умолчанию. Эти данные указываются в справках о проверке.
  2. Личность владельца — владелец аккаунта проходит обычную проверку. При GREEN аккаунт подтверждается; ON_HOLD рассматривают сотрудники GOXOST; после RED можно попробовать снова (всего 3 попытки).

Пока оба шага не пройдены, любой запрос с ключом sk_live_ возвращает ошибку 403 tenant_not_verified.

4. Способ интеграции

Все способы используют один и тот же API и вебхуки:

Способ Для чего
Ссылка (hosted-страница) Самый быстрый старт: ссылка в письме, SMS, чате или QR-коде
Веб-SDK (kyc.js) Чтобы клиент оставался на вашем сайте
Flutter SDK Приложения для Android и iOS
Плагин WordPress Сайты на WordPress
Direct API Собственный интерфейс съёмки или проверка изображений, которые уже есть у вас

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

  1. Ваш сервер создаёт заявителя (POST /applicants).
  2. Создаёт для него сессию и получает одноразовую ссылку (url) и token.
  3. Клиент проходит проверку.
  4. GOXOST KYC отправляет вебхук на ваш сервер.
  5. Ваш сервер читает решение через GET /verifications/{id}.

Окончательное решение всегда принимайте на сервере — по вебхуку или через API. Результат в браузере или приложении нужен только для удобства пользователя.

Документация

Полное руководство, примеры кода и справочник API: https://kyc.goxost.net/docs. Начните с главы «Быстрый старт» — первая проверка в тестовой среде за пять шагов.

Статья была полезной?

Не нашли ответ?

Отправьте обращение — специалист проверит ваш аккаунт и ответит.