Skip to main content

Quickstart - Pierwsza weryfikacja

Ten przewodnik pokazuje jak utworzyć pierwszą sesję weryfikacyjną w 4 krokach.

Krok 1: Uzyskaj klucz API​

Wygeneruj klucz testowy w panelu administracyjnym - patrz Klucz API. Format: deid_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.

Krok 2: Utwórz sesję weryfikacyjną​

Wyślij POST na endpoint /verifications z wybraną metodą weryfikacji:

curl -X POST https://WSKAZANY_PRZEZ_SUPPORT.snd.dpay.pl/api/v1/verifications \
  -H "Authorization: Bearer deid_test_twoj_klucz_api" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "bank_transfer",
    "external_id": "zamowienie-12345",
    "redirect_url": "https://twoja-strona.pl/weryfikacja-zakonczona",
    "locale": "pl"
  }'

Odpowiedź (201 Created)​

{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "created",
    "purpose": "identity_verification",
    "mode": "single",
    "provider": "bank_transfer",
    "external_id": "zamowienie-12345",
    "verification_url": "https://hub.dpay.pl/v/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "redirect_url": "https://twoja-strona.pl/weryfikacja-zakonczona",
    "locale": "pl",
    "metadata": null,
    "is_test_mode": true,
    "expires_at": "2026-04-07T11:00:00+00:00",
    "completed_at": null,
    "created_at": "2026-04-07T10:30:00+00:00",
    "updated_at": "2026-04-07T10:30:00+00:00"
  }
}

Zapamiętaj pole id (UUID sesji) i verification_url (URL do przekierowania użytkownika).

Krok 3: Przekieruj użytkownika​

Przekieruj użytkownika końcowego pod adres z pola verification_url. Użytkownik przejdzie cały proces weryfikacji na stronie HUB-a (np. wykona mikroprzelew, zeskanuje kod QR mObywatel itp.).

Po zakończeniu HUB przekieruje go z powrotem na adres podany w redirect_url.

Krok 4: Odbierz wynik​

Po zakończeniu weryfikacji masz dwa sposoby odebrania wyniku:

Opcja A: Webhook (zalecane)​

Skonfiguruj endpoint webhook (patrz Webhooks). Otrzymasz powiadomienie typu verification.completed natychmiast po zakończeniu sesji.

Opcja B: Polling​

Odpytaj endpoint /verifications/{id}/result:

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

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"
  }
}
Dane PII

Pole verified_data zawiera dane osobowe (PII). Przechowuj je zgodnie z wymogami RODO - patrz Dane PII.

Co dalej?​

Last updated on