SPID
Overview
Italy’s national digital identity framework provided by various certified issuers. SPID is widely adopted and used by nearly 90% of the online population for authentication across public and private online services.
- ID:
italy-spid - Type: eID (app)
- Verification Type: Presentation
- Regions: Europe
- Countries: IT, SM, VA
- Adoption: 41,000,000
- URL: https://www.spid.gov.it/en/
Integration with Trinsic
- Permission required: Yes, this method requires registration before you can activate it for your users. Please contact Trinsic to begin this process.
- Cost: Contact the Trinsic team.
User Flow
After clicking the SPID button, the user sees a list of SPID identity providers. They select their identity provider and then inputs their user name and password. Depending on the requested level of assurance, they user might also be prompted to enter a one time passcode, or a code confirmation in their identity provider's mobile app. Once authenticated, the user consents to sharing their data and the flow is complete. To see a demo, watch this video.
How to Test
- While using a test mode App, select the
spidprovider. - Enter one of the following details:
- Level 1: Nome utente
cesarePasswordpassword123.- By default, this account will fail verification, as it does not meet the specified SPID Level of
2.
- By default, this account will fail verification, as it does not meet the specified SPID Level of
- Level 2: Nome utente
adaPasswordpassword123. - Level 3: Nome utente
marcopoloPasswordpassword123.
- Level 1: Nome utente
- Click
Conferma
Direct API Requirements
Direct API is not a requirement.You can integrate with this provider using the Hosted UI instead, with no additional integration requirements on your end.
What your integration must support in order to use this provider with the Direct Provider Sessions API.
- Supports Direct Provider Sessions: ✅
- Launch Method:
LaunchBrowser— Send the user's browser (via redirect, popup, or new tab) to the given URL. - Collection Method:
CaptureRedirect— The user is redirected back to your app with aresultsAccessKeyupon completion. - Requires Input: This provider requires input before verification can proceed.
- Trinsic-Hosted UI: A Trinsic-Hosted Fallback UI exists for this provider, which may be invoked to cover gaps in your integration's capabilities.
Outputs
Normalized AttributesThese attributes form part of our normalized model, a standardized set used across providers. Trinsic normalizes this for you and lets you know when a property is available for each provider.
| Field | Availability | Notes |
|---|---|---|
person.givenName | Always | - |
person.familyName | Always | - |
person.dateOfBirth | Always | - |
person.sex | Sometimes | If available |
person.phoneNumber | Sometimes | If available |
person.address.line1 | Sometimes | If address is available |
person.address.city | Sometimes | If address is available |
person.address.subdivision | Sometimes | If address is available |
person.address.postalCode | Sometimes | If address is available |
person.address.country | Sometimes | If address is available |
document.type | Always | - |
document.number | Always | - |
document.issueDate | Always | - |
document.expirationDate | Sometimes | If available |
document.issuingAuthority | Always | - |
| Field | Optional | Description | Example Values |
|---|---|---|---|
billingInformation.isBillable | Yes | Whether this SPID verification has resulted in a billable event. | true, false |
billingInformation.verificationType | Yes | The billable verification type for this SPID verification. Possible values: "Authentication" | "Registration" | "Authentication", "Registration" |
billingInformation.verificationLevel | Yes | The billable verification level for this SPID verification. Possible values: 1 | 2 | 3 | 1, 2, 3 |
identityProviderEntityId | Yes | The SPID Entity ID of the Identity Provider which issued the SPID identity. This is an HTTPS URI which uniquely identifies the IdP within the SPID federation. A normalized / simplified representation of this value is present in the originatingSubProviderId field in Trinsic's normalized data model. | https://spid.register.it |
spidCode | Yes | The identifier of the SPID credential, uniquely identifying it within the SPID federation. The format of this string is specific to each individual Identity Provider. | SPID-002 |
spidCredentialExpirationDate | Yes | Expiration date of the SPID credential. This is not the same as the expiration date of the underlying identity document (such as a passport) which was used to create the SPID identity. | 2030-12-21 |
rawIdCard | Yes | The raw, space-separated string value for the "IdCard" field from the SPID credential. Trinsic additionally parses this field and uses it to populate the Document object in the normalized data model. | passaporto KK1234567 questuraLivorno 2016-09-04 2026-09-03 |
givenName | Yes | The individual's first / given name(s) | Ada |
familyName | Yes | The individual's last / family name(s) | Lovelace |
dateOfBirth | Yes | The date of birth of the individual | 1985-12-10 |
gender | Yes | The gender of the individual. Possible values: "M" | "F" | F |
placeOfBirth | Yes | The individual's place of birth. This is a 4-digit Belfiore Code identifying either the municipality of birth (for births in Italy) or a foreign country (for births outside Italy). | G702 |
countyOfBirth | Yes | The individual's county (province) of birth, abbreviated. For foreign births, this is "EE". | PI |
domicileStreetAddress | Yes | The street address of the individual's residence. This includes street name, street type, and house number, in the standard format for the given state. | Via Liszt 21 |
domicilePostalCode | Yes | The postal code of the individual's residence | 00144 |
domicileMunicipality | Yes | The municipality of the individual's residence | Rome |
domicileProvince | Yes | The province of the individual's residence | RM |
domicileNation | Yes | The 2-digit country code of the individual's residence | IT |
email | Yes | The email address of the individual | [email protected] |
mobilePhone | Yes | The mobile phone number of the individual, in Italian format. | 34912345678 |
digitalAddress | Yes | The PEC (Italian Certified Email) address of the individual or organization. | [email protected] |
fiscalNumber | Yes | Fiscal tax number for the individual. | TINIT-ABCXYZ00W00Z000Z |
ivaCode | Yes | The VAT number of the organization which was verified, or of the organization which the verified individual is associated with. | VATIT-12345678901 |
companyName | Yes | The name of the organization which was verified, or of the organization which the verified individual is associated with. | ACME Corporation |
companyFiscalNumber | Yes | The fiscal tax number of the organization which was verified, or of the organization which the verified individual is associated with. | TINIT-12345678901 |
registeredOffice | Yes | The registered office address of the organization which was verified, or of the organization which the verified individual is associated with. | via Listz 21 00144 Rome |
Frequently Asked Questions
Do we receive the image of the document used to onboard to SPID?
No, but you can receive the details of the identity document that was used to onboard to SPID in the IDcard attribute.
Can we get the place of issue and issuer for the document used to onboard to SPID?
SPID provides an attribute called issuingAuthority which is a combination the institution that issued the document, and the location where it was issued. For example, motorizzazioneCivileComo, prefetturaMilano or MinisteroInterno.
Updated 8 days ago