Hostowana weryfikacja tożsamości — decyzja należy do Ciebie

Kontrole i sygnały

Hostowany proces generuje wyniki kontroli dla weryfikującego. To sygnały wspierające weryfikację. Nie przesądzają o wyniku ani nie gwarantują blokowania oszustw.

Dla deweloperów

Poniższe przykłady pokazują zwykłe żądania HTTPS wysyłane z Twojego serwera. Pełny opis znajdziesz w dokumentacji.

3 sposoby rozpoczęcia weryfikacji

• Sesja hostowana utworzona z Twojego serwera. Twój serwer tworzy link przez API, a Noxtica hostuje stronę.
• Zaproszenie z Backoffice. Osoba z Twojej organizacji tworzy link w Backoffice, bez użycia kodu.
• Bezpośrednie API z Twojego serwera. Ścieżki komunikacji serwer-serwer bez hostowanego linku. Nie umożliwiają obecnie przechwycenia dokumentu do weryfikacji na własnych ekranach, dlatego gdy klient musi przechwycić dokument, użyj sesji hostowanej.

Utwórz sesję

Uwierzytelnij się kluczem serwerowym z uprawnieniem identity. Przechowuj klucz na swoim serwerze. Wysyłaj Idempotency-Key, aby ponowienie żądania nie utworzyło drugiej sesji.

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"}'

Odpowiedź

Link jest zwracany tylko raz, w tej odpowiedzi. Traktuj go jak sekret i nie zapisuj w logach. Czas wygaśnięcia podano w milisekundach epoki.

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

Odczytaj status

Utworzona przez Ciebie sesja zawsze zwraca 200, również po wygaśnięciu. Odpytuj ją z coraz dłuższym odstępem i zakończ po uzyskaniu statusu końcowego.

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

Zdarzenia webhook

Zdarzenia są dostarczane przez HTTPS z podpisem do punktu końcowego zarejestrowanego w Backoffice. Zdarzenie jest powiadomieniem, a nie decyzją.

Przykładowe zdarzenie

Wyłącznie wartości syntetyczne. Zdarzenia nigdy nie zawierają identyfikatora klienta: dopasuj zdarzenie do klienta za pomocą identyfikatora sesji.

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

Weryfikuj każde dostarczenie

• Każde dostarczenie zawiera nagłówki X-Noxtica-Signature, X-Noxtica-Timestamp, X-Noxtica-Event i X-Noxtica-Delivery.
• Podpis to HMAC-SHA256 obliczony na podstawie znacznika czasu, kropki i surowej treści żądania. Zweryfikuj go przed analizą treści i samodzielnie określ dopuszczalną tolerancję znacznika czasu.
• Zdarzenie jest dostarczane co najmniej raz, a kolejność nie jest ustalona. Usuń duplikaty na podstawie X-Noxtica-Delivery, a następnie sprawdź status sesji przed podjęciem działania.

Nie jest wymagany SDK. Dokumentacja zawiera przykłady użycia curl, Node.js i Python.

Więcej informacji w dokumentacji

• Integracja weryfikacji tożsamości
• Zdarzenia i webhooki
• Dokumentacja API serwerowego: KYC
• Zaproszenia i ustawienia hostowanej strony
• Bezpośrednie API
• Zasady żywotności i PAD
• FAQ i rozwiązywanie problemów
• Operacje w Backoffice

Częste pytania

Powiązane strony

• Zobacz przebieg weryfikacji hostowanej przez Noxtica
• Cennik
• Weryfikacja firm i sprzedawców (KYB i KYM)
• Dane weryfikacyjne: przechowywanie, dostęp i usuwanie
• Zasady ochrony prywatności
• Bezpieczeństwo