Проверка личности на размещённой странице, решение остаётся за вами

Проверки и сигналы

Размещённый процесс выдаёт результаты проверок для специалиста. Это сигналы для рассмотрения дела. Они не определяют исход и не гарантируют блокировку мошенничества.

Для разработчиков

Всё ниже — обычные HTTPS-запросы с вашего сервера. Полная справочная информация приведена в документации.

Три способа начать проверку

• Размещённый сеанс с вашего сервера. Ваш сервер создаёт ссылку через API, а Noxtica размещает страницу.
• Приглашение из Backoffice. Сотрудник вашей организации создаёт ссылку в Backoffice без кода.
• Прямой API с вашего сервера. Запросы между серверами без размещённой ссылки. Сейчас в собственных интерфейсах нельзя снять документ для проверки, поэтому используйте размещённый сеанс, если клиенту нужно снять документ.

Создание сеанса

Аутентифицируйтесь с помощью серверного ключа с разрешением на проверку личности. Храните ключ на своём сервере. Передавайте Idempotency-Key, чтобы повторный запрос не создавал второй сеанс.

curl -sS https://collect.noxtica.com/v1/kyc/sessions \
  -H "Authorization: Bearer $NOXTICA_SERVER_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"subjectRef":"cust_example","returnUrl":"https://merchant.example.com/verification/return"}'

Ответ

Ссылка возвращается один раз в этом ответе. Считайте её секретом и не записывайте в журналы. Срок действия указан в миллисекундах Unix.

{
  "ok": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "url": "https://verify.noxtica.com/s/EXAMPLE_TOKEN",
  "expiresAt": 1790848845000,
  "domainId": null,
  "requestId": "req_example"
}

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

Для созданного вами сеанса всегда возвращается 200, даже если срок его действия истёк. Опросите статус, постепенно увеличивая интервал, и остановитесь при окончательном статусе.

GET https://collect.noxtica.com/v1/kyc/sessions/00000000-0000-4000-8000-000000000001
Authorization: Bearer $NOXTICA_SERVER_KEY

События вебхуков

События отправляются на зарегистрированную в Backoffice конечную точку по HTTPS с цифровой подписью. Событие — это уведомление, а не решение.

Пример события

Только синтетические значения. События никогда не содержат ссылку на клиента: сопоставляйте событие с клиентом по идентификатору сеанса.

{
  "id": "00000000-0000-4000-8000-000000000001:endpoint_example",
  "type": "kyc.session.completed",
  "created_at": 1790762445000,
  "tenant_id": "tenant_example",
  "data": {
    "schemaVersion": "1",
    "sessionId": "00000000-0000-4000-8000-000000000001",
    "status": "completed",
    "verificationId": "verification_example",
    "reasonCodes": ["provider_manual_review"],
    "occurredAt": 1790762445000,
    "deliveryId": "00000000-0000-4000-8000-000000000001:endpoint_example"
  }
}

Проверяйте каждую доставку

• Каждая доставка содержит заголовки X-Noxtica-Signature, X-Noxtica-Timestamp, X-Noxtica-Event и X-Noxtica-Delivery.
• Подпись — это HMAC-SHA256 от временной метки, точки и исходного тела запроса. Проверьте её до разбора тела запроса и задайте допустимое отклонение временной метки самостоятельно.
• Доставка выполняется как минимум один раз, порядок не гарантирован. Удаляйте дубликаты по X-Noxtica-Delivery, затем проверяйте статус сеанса, прежде чем действовать.

SDK не требуется. В документации приведены примеры для curl, Node.js и Python.

Подробнее в документации

• Интеграция проверки личности
• События и вебхуки
• Справочник Server API: KYC
• Приглашения и настройки размещённой страницы
• Прямой API
• Правила проверки активности и PAD
• Часто задаваемые вопросы и устранение неполадок
• Операции в Backoffice

Часто задаваемые вопросы

Связанные страницы

• Посмотрите, как проходит проверка на размещённой странице
• Цены
• Проверка компаний и продавцов (KYB и KYM)
• Данные проверки: хранение, доступ и удаление
• Политика конфиденциальности
• Безопасность