Identity API
Verified customer data from the IDfier app or an EU Digital Identity Wallet, for login, age checks and verification links.
The Identity API gives your server verified data about a customer, after the customer approves in the IDfier app. There are two ways to ask:
| Login with IDfier | Verification links | |
|---|---|---|
| How the customer verifies | Scans a QR code on your site, or taps a button on their phone | Opens a link you send (IDfier can email it) |
| What they share | Your business client's scopes | Chosen per link |
| How you get the answer | Poll the result, or get a webhook and fetch it | Poll the link |
| Good for | Sign-up, login, checkout | Checking someone before a booking, rental or delivery |
Age verification works with both: ask for
an age scope such as ageOver18 and you get true or false, never the date
of birth.
Key concepts
- Business client: your company's credentials (
clientId,clientSecret) and the scopes it may receive. IDfier sets it up. - Session: one login, from QR code to approval, valid for 5 minutes,
identified by its
referenceId. - Scopes: which customer fields you receive, e.g.
fullname,email,ageOver18,authLevel. id: a stable identifier for a customer, unique to your business. Key your customer accounts on it.