Skip to main content

mObywatel

Provider: mobywatel

Identity verification through mObywatel, the official Polish government app that lets a user share personal data from an identity document.

How it works​

  1. The customer opens verification_url and sees a QR code
  2. The customer scans the QR code with the mObywatel app on their phone
  3. The customer confirms data sharing in the app
  4. mObywatel returns the data to the HUB, including the customer's first name, last name, PESEL and identity document details
  5. A verification.completed webhook is sent to your endpoint
POST/api/v1/verificationsCreate an mObywatel session: parameters, returned data and error codes.Full contract in the API Reference

When should I use it?​

  • Fastest verification - usually 30-60 seconds
  • No customer cost - no transfer or other payment is required
  • High identity confidence - the data comes directly from government registers
  • Good UX for younger users - most Polish users already have mObywatel

Session creation example​

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

Returned data​

After successful verification, verified_data contains:

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

Customer requirements​

  • An active mObywatel app on an iOS or Android phone equipped with a camera
  • An active identity card added to the app as mDowód
info

Customers who do not use mObywatel can be redirected to an alternative verification method. Consider pool mode with bank_transfer as a fallback.

Cost and timing​

  • Customer cost: PLN 0 - no fees
  • Verification time: 30-60 seconds
  • Session TTL: 30 minutes from creation

Alternatives​

Last updated on