Размешчаная праверка асобы, рашэнне застаецца за вамі

Праверкі і сігналы

Размешчаны працэс выдае вынікі праверак для спецыяліста, які разглядае справу. Гэта сігналы для разгляду. Яны не вызначаюць вынік і не гарантуюць блакіроўку махлярства.

Для распрацоўшчыкаў

Усё ніжэй — звычайны 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"}'

Адказ

Спасылка вяртаецца адзін раз у гэтым адказе. Лічыце яе сакрэтам і не запісвайце ў журналы. Час заканчэння тэрміну дзеяння пазначаны ў мілісекундах эпохі.

{
  "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

Падзеі webhook

Падзеі дастаўляюцца на зарэгістраваны ў Backoffice endpoint праз 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.

Даведацца больш у дакументацыі

• Інтэграцыя праверкі асобы
• Падзеі і webhook
• Даведка па Server API: KYC
• Запрашэнні і налады размешчанай старонкі
• Прамы API
• Палітыка праверкі актыўнасці і PAD
• FAQ і вырашэнне праблем
• Аперацыі ў Backoffice

Частыя пытанні

Звязаныя старонкі

• Паглядзіце на размешчаны працэс праверкі
• Цэны
• Праверка кампаній і гандляроў (KYB і KYM)
• Даныя праверкі: захоўванне, доступ і выдаленне
• Палітыка прыватнасці
• Бяспека