Wynik weryfikacji

Po zakończeniu sesji (status completed) możesz pobrać szczegółowy wynik zawierający dane osobowe, wskaźnik pewności i ewentualne powody odrzucenia.

Endpoint

GET /api/v1/verifications/{id}/result

Przykład

curl https://hub.dpay.pl/api/v1/verifications/a1b2c3d4-e5f6-7890-abcd-ef1234567890/result \
  -H "Authorization: Bearer deid_live_xxx"

Odpowiedź (200 OK)

{
  "data": {
    "id": "f1e2d3c4-b5a6-7890-dcba-0987654321fe",
    "verification_session_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "verified",
    "confidence_score": 0.95,
    "verified_data": {
      "first_name": "Jan",
      "last_name": "Kowalski",
      "pesel": "90010112345"
    },
    "rejection_reasons": null,
    "verified_at": "2026-04-07T10:35:00+00:00",
    "created_at": "2026-04-07T10:35:00+00:00"
  }
}

Pola odpowiedzi

Pole	Typ	Opis
id	uuid	ID wyniku weryfikacji
verification_session_id	uuid	UUID sesji weryfikacyjnej
status	string	Status wyniku: verified, rejected, inconclusive
confidence_score	number|null	Wskaźnik pewności (0-1, gdzie 1 = pewność 100%)
verified_data	object|null	Zweryfikowane dane osobowe (PII) - patrz Dane PII
rejection_reasons	array|null	Lista powodów odrzucenia (jeśli status: rejected)
verified_at	datetime|null	Data weryfikacji
created_at	datetime	Data utworzenia rekordu wyniku

Statusy wyniku

Status	Opis
verified	Tożsamość potwierdzona - verified_data zawiera dane osobowe
rejected	Tożsamość odrzucona - powody w rejection_reasons
inconclusive	Wynik niejednoznaczny - wymaga ręcznej oceny

Szczegóły w sekcji Statusy.

Confidence score

Pole confidence_score (0-1) wskazuje pewność weryfikacji:

Zakres	Interpretacja
0.95 - 1.0	Bardzo wysoka pewność
0.80 - 0.94	Wysoka pewność
0.50 - 0.79	Średnia pewność (warto rozważyć dodatkową weryfikację)
< 0.50	Niska pewność (rekomendowane odrzucenie lub ręczna ocena)

Dla statusu verified zazwyczaj wartość wynosi > 0.90. Niższe wartości mogą wystąpić dla statusu inconclusive.

Powody odrzucenia

Dla status: rejected pole rejection_reasons zawiera listę kodów powodów:

{
  "data": {
    "status": "rejected",
    "confidence_score": 0.30,
    "verified_data": null,
    "rejection_reasons": [
      "WRONG_AMOUNT",
      "DATA_MISMATCH"
    ]
  }
}

Dostępne powody zależą od dostawcy - patrz dokumentacja konkretnej metody weryfikacji.

Błędy

Kod	Błąd	Opis
404	RESULT_NOT_AVAILABLE	Wynik nie jest jeszcze dostępny - sesja w trakcie lub nie istnieje

Przykład błędu 404

{
  "error": {
    "code": "RESULT_NOT_AVAILABLE",
    "message": "Verification result is not yet available. Current status: processing"
  }
}

Kiedy pobierać wynik?

Najlepszy sposób: odebrać webhook verification.completed lub verification.failed, a następnie wykonać GET /verifications/{id}/result aby pobrać pełne dane.

Alternatywa (polling): okresowo sprawdzać GET /verifications/{id} (status sesji), a po przejściu w completed pobrać wynik. Mniej efektywne - wykorzystuje rate limit.

Bezpieczeństwo

ważne

Pole verified_data zawiera dane osobowe (PII) szyfrowane w bazie HUB algorytmem AES-256-GCM. Przechowuj te dane zgodnie z wymogami RODO - patrz Dane PII.