Tryby weryfikacji

DPay Web EID oferuje cztery tryby (mode) prowadzenia sesji weryfikacyjnej. Wybór trybu zależy od scenariusza biznesowego.

Porównanie trybów

Klient

Twój serwer

DPay HUB

Dostawca

Press enter or space to select a node. You can then use the arrow keys to move the node around. Press delete to remove it and escape to cancel.

Press enter or space to select an edge. You can then press delete to remove it or escape to cancel.

Dozwolone kombinacje purpose × mode

Purpose	single	sequential	pool	dynamic
identity_verification	Tak	Tak	Tak	Nie
account_data	Tak	Tak	Nie	Tak

Auto-przełączanie

Dla purpose=account_data z bank_selection=user_driven (lub bez podania), tryb jest automatycznie ustawiany na dynamic.

Tryb single (domyślny)

Jeden dostawca weryfikacji - najprostszy scenariusz. Idealny gdy z góry wiesz jakiej metody chcesz użyć.

curl -X POST https://hub.dpay.pl/api/v1/verifications \
  -H "Authorization: Bearer deid_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"provider": "bank_transfer"}'

Wymagane pole: provider

Tryb sequential (wieloetapowy)

Wielokrokowa weryfikacja - użytkownik przechodzi przez każdy krok po kolei. Używaj gdy potrzebujesz wzmocnić poziom weryfikacji łącząc kilka metod.

curl -X POST https://hub.dpay.pl/api/v1/verifications \
  -H "Authorization: Bearer deid_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "sequential",
    "steps": [
      {"provider": "bank_transfer"},
      {"provider": "mobywatel"}
    ]
  }'

Wymagane pole: steps (tablica 2-10 obiektów)

W odpowiedzi pojawiają się dodatkowe pola:

• current_step - numer bieżącego kroku
• total_steps - łączna liczba kroków
• steps - tablica obiektów VerificationStep z indywidualnymi statusami

Tryb pool (wybór użytkownika)

Użytkownik wybiera jedną z dostępnych metod weryfikacji na stronie HUB-a. Najlepsze UX gdy chcesz dać klientowi swobodę.

curl -X POST https://hub.dpay.pl/api/v1/verifications \
  -H "Authorization: Bearer deid_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "pool",
    "providers": ["bank_transfer", "mobywatel", "demo"]
  }'

Wymagane pole: providers (tablica 2-10 stringów)

W odpowiedzi pojawia się pole allowed_providers z listą dostawców do wyboru.

Tryb dynamic (AIS/PSD2)

Dedykowany dla dostępu do danych rachunkowych. Użytkownik może dynamicznie dodawać kolejne banki w trakcie sesji.

curl -X POST https://hub.dpay.pl/api/v1/verifications \
  -H "Authorization: Bearer deid_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "purpose": "account_data",
    "provider": "ais_psd2",
    "bank_selection": "user_driven",
    "max_banks": 5,
    "min_banks": 1
  }'

Wymagane pola: provider (musi być ais_psd2)

Parametry trybu dynamic

Parametr	Typ	Domyślnie	Opis
bank_selection	string	user_driven	fixed (z góry) lub user_driven (klient wybiera)
max_banks	integer	10	Maksymalna liczba banków (1-20)
min_banks	integer	1	Minimalna liczba banków (1-20)

W odpowiedzi pojawiają się dodatkowe pola:

• bank_selection_mode - tryb wyboru banków
• max_banks / min_banks - limity banków
• banks_connected - ile banków już połączono
• current_step / total_steps / steps - stan kroków (każdy bank = krok)

Kiedy używać którego trybu?

Scenariusz	Rekomendowany tryb
Onboarding klienta z weryfikacją tożsamości	single (bank_transfer lub mobywatel)
KYC wzmocniony - dwa źródła weryfikacji	sequential
Dajesz klientowi wybór metody	pool
Pobieranie historii transakcji z wielu banków	dynamic (ais_psd2)