Перевірка особи на розміщеній сторінці, а рішення — за вами

Перевірки та сигнали

Хостингований процес надає результати перевірок для фахівця, який розглядає справу. Це сигнали для перевірки. Вони не визначають результат і не гарантують блокування шахрайства.

Для розробників

Усе нижче працює через звичайний 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)
• Дані перевірки: зберігання, доступ і видалення
• Політика конфіденційності
• Безпека