Przejdź do głównej zawartości

mObywatel

Provider: mobywatel

Weryfikacja tożsamości przez aplikację mObywatel - oficjalną aplikację rządową umożliwiającą udostępnienie danych osobowych z dokumentu tożsamości.

Jak to działa​

  1. Klient otwiera verification_url i widzi kod QR
  2. Skanuje kod QR w aplikacji mObywatel na swoim telefonie
  3. W aplikacji potwierdza udostępnienie danych
  4. mObywatel zwraca dane do HUB (imię, nazwisko, PESEL, dane dokumentu)
  5. Webhook verification.completed trafia na Twój endpoint

Kiedy używać?​

  • Najszybsza weryfikacja - zazwyczaj 30-60 sekund
  • Brak kosztów dla klienta - nie potrzebny przelew ani inny wydatek
  • Wysoka pewność tożsamości - dane pochodzą bezpośrednio z państwowych rejestrów
  • Dobry UX dla młodszych użytkowników - większość Polaków ma już mObywatela

Przykład utworzenia sesji​

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

Zwracane dane​

Po pozytywnej weryfikacji verified_data zawiera:

{
  "first_name": "Jan",
  "last_name": "Kowalski",
  "pesel": "90010112345",
  "id_document_number": "ABC123456",
  "id_document_type": "id_card",
  "date_of_birth": "1990-01-01",
  "nationality": "PL"
}

Wymagania po stronie klienta​

  • Aktywna aplikacja mObywatel na telefonie z systemem iOS lub Android wyposażonym w aparat
  • Aktywny dowód osobisty dodany do aplikacji (mDowód)
informacja

Klienci bez mObywatela mogą zostać przekierowani na alternatywną metodę weryfikacji - rozważ użycie trybu pool z fallbackiem na bank_transfer.

Koszt i czas​

  • Koszt klienta: 0 PLN - brak opłat
  • Czas weryfikacji: 30-60 sekund
  • TTL sesji: 30 minut od utworzenia

Alternatywy​

Ostatnia aktualizacja dnia