cryptographic: un proveïdor d’identitat ha autenticat la persona i ha signat els atributs retornats. Això és tot el que afirma el nivell. No és una classificació respecte als altres dos nivells —descriuen proves diferents, no més o menys de la mateixa cosa— i el temps que triga un inici de sessió depèn del flux propi de la cartera, que Didit no controla ni promet.
Tria la teva integració
Utilitza les API de carteres d’identitat digital quan la teva aplicació gestioni la interfície i els passos d’autenticació. Cada cartera té un endpoint d’inici dedicat, amb endpoints compartits de resultat, sondeig i cancel·lació. No cal que creïs cap flux de treball. Utilitza l’API de Sessions per al recorregut de cartera allotjat de Didit, les regles de flux de treball i el mecanisme alternatiu basat en documents configurat. La disponibilitat de la cartera, l’aprovació requerida de l’usuari i els atributs d’identitat verificats s’apliquen a tots dos mètodes d’integració.Requisits previs
Cada cartera requereix una identitat activa amb l’emissor indicat a continuació i accés al seu mètode d’autenticació. El compte ha de ser apte per als atributs sol·licitats, i l’usuari ha de donar el seu consentiment per compartir-los. Una signatura verifica l’emissor i les declaracions retornades; no garanteix que tots els atributs sol·licitats siguin presents, actualitzats o suficients per a la teva política de compliment. Una cartera sense retrat no inclou cap comparació amb selfie. A continuació es llisten les 25 entrades de carteres del catàleg, incloent-hi ambdós països amb BankID, ConnectID, Estonian ID-card i eParaksts mobile. Un mecanisme alternatiu basat en documents configurat executa una comprovació de documents independent. No es promet cap data de llançament. Aquestes són carteres d’identitat. El cribratge de carteres cripto comprova adreces de blockchain per detectar riscos financers i és un producte independent.Preus
✅ Disponible significa activat en producció. ⏳ Properament significa que encara no està activat en producció, fins i tot si s’han iniciat les proves d’integració. Les carteres disponibles apareixen primer. A petició a la columna de preu significa que la cartera està disponible però no té una tarifa minorista publicada; no significa verificació gratuïta. Aquests són els preus estàndard de Didit en USD per verificació de cartera completada per als productes d’identitat llistats a continuació. El preu indicat inclou la comprovació d’identitat de la cartera; no s’hi afegeix cap comissió de transacció d’eID nacional addicional. Una tarifa específica acordada per a l’organització té preferència.
Properament a la columna de preus significa que la cartera està planificada i que el seu preu per a clients encara no s’ha publicat. No significa que la verificació sigui gratuïta. Les banderes de països mostren la cobertura del catàleg de la cartera; la columna de disponibilitat independent mostra si actualment es pot activar.
Un preu publicat no activa una cartera. La disponibilitat indicada més amunt prové del catàleg de producció. Una cartera marcada com a Properament encara no es pot seleccionar en un flux de treball; aquestes tarifes s’aplicaran quan estigui disponible.
- Un inici de sessió verificat amb cartera es cobra una vegada per node de Verificació d’identitat en un flux de treball, o una vegada per sol·licitud de verificació a través de l’API de carteres independent. Les repeticions de callbacks o les comprovacions d’estat no generen cap càrrec addicional.
- Els inicis de sessió cancel·lats, caducats, rebutjats o incomplets no generen cap càrrec de verificació de cartera.
- Els preus de les carteres són preus de catàleg: el descompte del teu pla se’ls aplica igual que a qualsevol altra comprovació.
- Una alternativa amb document és una comprovació independent, facturada segons els preus de verificació de documents. Les altres funcionalitats completades del flux de treball es facturen per separat.
Què fa l’usuari
- Tria el seu país al pas d’identificació i selecciona una cartera d’entre les que acceptes.
- Inicia sessió amb aquesta cartera, de la mateixa manera que inicia sessió al seu banc o al seu portal governamental.
- Aprova compartir els seus atributs d’identitat amb tu.
- Torna verificat.
Les carteres formen una llista d’acceptació
wallet.providers és la llista de carteres que pot oferir un país. No és una classificació: l’ordre que envies no té cap rellevància, es normalitza a l’ordre del catàleg en desar-se, i l’usuari final tria entre les que hagis acceptat. Activa una sola cartera o totes les carteres d’un país: l’elecció és seva.
L’API rebutja un flux de treball que activi una cartera que el catàleg no ofereixi en aquest país, o una que encara estigui marcada com a Properament.
La llista d’atributs de cada cartera a continuació inclou una atestació signada. Didit verifica aquesta signatura i informa del veredicte com a
wallet_verification.signature_valid a la sessió; la pròpia atestació no es retorna, de manera que no hi ha cap referència per obtenir ni emmagatzemar. La columna A la sessió indica quin dels dos reps per a cada atribut.Carteres compatibles
Les carteres disponibles són MitID, BankID Sweden, iDIN, Finnish Trust Network, Smart-ID i Mobile-ID. iDIN està disponible per a una identificació completa als Països Baixos. Smart-ID i Mobile-ID estan disponibles als països llistats al catàleg següent. La cobertura de països i les dades d’entrada sol·licitades per a Smart-ID i Mobile-ID reflecteixen la integració implementada; la disponibilitat en producció es continua controlant per separat. Fes servir la guia d’integració per a les rutes de Smart-ID i Mobile-ID implementades.La disponibilitat la proporciona el catàleg de capacitats, no es manté manualment aquí. Properament significa que la cartera és visible a la consola i encara no es pot activar; no comporta cap data compromesa.
Estonian ID-card i eParaksts mobile
Tots dos mètodes estan integrats al catàleg de carteres, però continuen marcats com a Properament a producció. No es poden activar en fluxos de treball de producció fins que el catàleg de producció els marqui com a Disponible. Els identificadors de l’API sónidcard_ee per a Estònia (EST) i eparaksts_mobile per a Letònia (LVA).
Tots dos tenen un preu de $0.55 per verificació completada quan estiguin disponibles; una tarifa publicada no n’habilita l’accés a producció.
- Estonian ID-card: l’usuari continua al navegador de l’ordinador connectat al seu lector de targetes intel·ligents i s’autentica amb la seva targeta i PIN mitjançant el programari de la targeta.
- eParaksts mobile: l’usuari passa al servei d’autenticació d’identitat i aprova amb el seu compte actiu d’eParaksts mobile. Els usuaris d’escriptori poden escanejar el codi QR per continuar al seu telèfon; els usuaris de telèfon continuen directament.
La marca blanca s’aplica a les pantalles de verificació de Didit.
Les pantalles d’autenticació externes d’aquests dos mètodes conserven la imatge de marca del seu servei.
Els logotips personalitzats, els noms de servei i l’estil de marca blanca no es traslladen a aquestes pantalles externes.
Utilitza aquestes carteres mitjançant l’API
Tots dos mètodes també admeten la verificació autònoma per API sense unworkflow_id.
La disponibilitat a producció és la mateixa per a l’API autònoma i per als fluxos de treball; consulta GET /v3/id-verification/wallets/ abans d’oferir qualsevol dels dos mètodes als usuaris.
Conserva la teva
x-api-key al teu backend i registra el host de retorn de la teva aplicació a la seva configuració allowed_return_hosts.
Envia una return_url HTTPS en aquest host en iniciar una verificació.
La resposta d’inici retorna un request_id i una wallet_verification.next_action.url per al navegador de l’usuari.
Redirigeix l’usuari a aquest URL perquè pugui autenticar-se amb la seva targeta o aplicació.
Quan torni, recupera GET /v3/id-verification/wallets/verifications/{request_id}/ des del teu backend per comprovar el resultat verificat, o bé processa el webhook signat status.updated.
No consideris la redirecció del navegador per si sola com a prova d’una verificació satisfactòria.
Les mateixes regles de preu i de facturació per verificació completada s’apliquen a ambdues opcions d’integració.
Google Wallet
Google Wallet permet que una persona comparteixi un document d’identitat oficial des del seu telèfon amb la teva pàgina o aplicació, mitjançant la Digital Credentials API del W3C. Està disponible a producció i a sandbox. Les aplicacions de sandbox no necessiten cap registre. Cada aplicació de producció es registra una vegada abans de poder utilitzar Google Wallet: a la consola, obre el pas de verificació d’identitat, cerca la fila de Google Wallet d’un país admès, tria Registra amb Google i completa la configuració d’un sol ús, que triga aproximadament un minut. Llavors, Google mostra el teu nom i logotip quan les persones comparteixen el seu document d’identitat. Fins que l’aplicació no estigui registrada, desar un flux de treball que activi Google Wallet es rebutja amb «Registra aquesta aplicació amb Google abans d’activar Google Wallet.» Els usuaris finals dels teus clients veuen l’opció com a Verifica amb un document d’identitat digital, perquè a més de Google Wallet qualsevol altra cartera d’Android que admeti la mateixa sol·licitud OpenID4VP i contingui un document d’identitat compatible (un passi d’identitat o un permís de conduir mòbil) pot respondre-hi.- Països: Estats Units, Regne Unit, Brasil, Singapur i Taiwan.
- Credencials: el passi d’identitat de Google Wallet creat a partir d’un passaport, a més dels permisos de conduir mòbils dels estats dels EUA admesos.
- Dades retornades: nom, data de naixement, número de document, data de caducitat del document, país emissor i autoritat emissora, i nacionalitat per a un passi d’identitat.
El resultat també inclou el veredicte
signature_validper a la credencial. No es comparteix cap retrat. - Privacitat: Didit sol·licita només els camps que necessita, i només aquests camps en surten. La persona aprova l’intercanvi de dades a Google Wallet al seu propi dispositiu.
digital-credentials-get a l’atribut allow del teu iframe: sense això, el navegador rebutja la sol·licitud de cartera dins de l’iframe.
Altres carteres properes
ConnectID (Austràlia) està integrat per a proves en sandbox i apareix al catàleg de carteres com aconnectid.
La persona selecciona un banc de proves participant mitjançant el selector de ConnectID, inicia sessió amb aquest banc i revisa la sol·licitud per compartir dades.
El paquet d’identitat inicial sol·licita el nom de pila, els cognoms i la data de naixement, amb una referència de transacció per a la verificació.
No sol·licita cap adreça, número de telèfon, adreça de correu electrònic, saldo del compte ni historial de transaccions.
L’avís per compartir dades identifica Didit i l’empresa que rep la identitat verificada.
Les credencials bancàries romanen al banc.
L’accés a producció continua en estat Properament; les proves en sandbox no habiliten la verificació d’identitat en entorns reals.
Cal completar un cas d’ús de producció aprovat, l’alta de clients, els termes requerits i la certificació abans de l’activació.
La resta de carteres marcades com a Properament a les taules tampoc no estan disponibles a producció.
No es compromet cap data de llançament.
Nivell de garantia
Quan una cartera proporciona un nivell de garantia eIDAS (low, substantial o high), Didit registra el nivell declarat realment al resultat.
Una cartera sense un nivell eIDAS especificat, com ConnectID, es mostra com a Sense especificar; la seva integració no implica cap declaració de garantia eIDAS.
Si una cartera retorna un nivell inferior al sol·licitat, l’inici de sessió falla en comptes de rebaixar el nivell de manera silenciosa.
Comprova wallet_verification.level_of_assurance a la sessió quan les teves regles de compliment en depenguin.
Referència per cartera
MitID
mitid · Disponible
Informació introduïda a Didit: Nom · Data de naixement · Àlies CPR (pseudonimitzat)
BankID
bankid_se · Disponible
Informació introduïda a Didit: Nom · Número personal
iDIN
idin · Disponible
Informació introduïda a Didit: Nom · Data de naixement · Adreça
Finnish Trust Network
ftn · Disponible
Informació introduïda a Didit: Nom · Codi d’identitat personal
Google Wallet
google_wallet · Disponible
Informació introduïda a Didit: No s’introdueixen dades d’identitat a Didit
Smart-ID
smart_id · Disponible
Informació introduïda a Didit: Codi d’identificació personal
Mobile-ID
mobile_id · Disponible
Informació introduïda a Didit: Codi d’identificació personal · Número de telèfon de Mobile-ID
BankID
bankid_no · Properament
Informació introduïda a Didit: Nom · Data de naixement · Número d’identitat nacional
Vipps
vipps · Properament
Informació introduïda a Didit: Nom · Data de naixement · Número d’identitat nacional
Buypass ID
buypass · Properament
Informació introduïda a Didit: Nom · Data de naixement · Número d’identitat nacional
itsme
itsme · Properament
Informació introduïda a Didit: Nom · Data de naixement · Número de registre nacional
Personalausweis
personalausweis · Properament
Informació introduïda a Didit: Nom · Data de naixement · Nacionalitat · Adreça
Freja eID
frejaid · Properament
Informació introduïda a Didit: Nom · Data de naixement · Número personal
UAE PASS
uae_pass · Properament
Informació introduïda a Didit: Nom · Número d’Emirates ID · Nacionalitat · Retrat
gov.br
govbr · Properament
Informació introduïda a Didit: Nom · CPF
OneID
oneid · Properament
Informació introduïda a Didit: Nom · Data de naixement
GOV.UK Wallet
govuk_wallet · Properament
Informació introduïda a Didit: Nom · Data de naixement · Retrat
Targeta d’identitat estoniana
idcard_ee · Properament
Informació introduïda a Didit: Nom · Data de naixement · Codi d’identificació personal
eParaksts mobile
eparaksts_mobile · Properament
Informació introduïda a Didit: Nom · Data de naixement · Codi d’identificació personal
Bank iD
bankid_cz · Properament
Informació introduïda a Didit: Nom · Data de naixement
MojeID
mojeid · Properament
Informació introduïda a Didit: Nom · Data de naixement
Diia
diia · Properament
Informació introduïda a Didit: Nom · Data de naixement · Retrat
FranceConnect
franceconnect · Properament
Informació introduïda a Didit: Nom · Data de naixement
Auðkenni
audkenni · Properament
Informació introduïda a Didit: Nom · Kennitala
ConnectID
connectid · Properament
Informació introduïda a Didit: No s’introdueix cap dada d’identitat a Didit
Cartera EUDI
eudi · Properament
Informació introduïda a Didit: PID - dades d’identificació de la persona
Errors i mecanisme alternatiu
Qualsevol resultat diferent de
verified segueix el commutador wallet.on_failure del país: fallback_to_document envia l’usuari a la captura de documents, decline finalitza la sessió amb una Verificació d’identitat rebutjada. fallback_to_document amb la captura de documents desactivada per a aquest país rebutja la sessió, ja que no hi ha cap alternativa a la qual recórrer.
Per mostrar la captura de documents només després d’un inici de sessió fallit amb la cartera, consulta Oferir la captura de documents només com a alternativa.
Només es factura un inici de sessió completat. Els inicis de sessió abandonats, cancel·lats, que han superat el temps d’espera i fallits no tenen cap cost.
Què arriba a la sessió
attributes conté les declaracions validades de la cartera, els noms de les quals varien segons la cartera.
Utilitza full_name i date_of_birth al resultat de la verificació d’identitat per als camps d’identitat normalitzats.
La taula específica de cada cartera distingeix aquests camps normalitzats dels atributs específics de la cartera. portrait només és present en les carteres que en comparteixen un. signature_valid és el resultat de validar l’asserció signada que ha retornat la cartera. És true en un inici de sessió completat: una asserció que no es valida correctament fa fallar l’inici de sessió i segueix wallet.on_failure en lloc de generar un resultat aprovat.
Els tipus de camp complets es troben al model de dades de verificació d’identitat.
Configuració de carteres
Aquest és un fragment de configuració que s’ha d’utilitzar només quan el catàleg del teu entorn marqui cada cartera seleccionada com aavailable al país seleccionat.
Enviar una cartera que no estigui disponible fa que es rebutgi el desament de tot el flux de treball, incloent-hi qualsevol altre mètode de la mateixa sol·licitud.
Per veure exemples de Smart-ID i Mobile-ID, consulta la guia d’integració.
wallet.enabled sigui true, o el desament serà rebutjat. La referència completa es troba a Configuracions de funcionalitats del flux de treball.
Relacionat
- Integració amb Finnish Trust Network - Finlàndia, autenticació bancària i alternativa documental
- Integració amb Smart-ID i Mobile-ID - cobertura per països, codis de comparació i configuració del flux de treball
- Mètodes de verificació d’identitat — els tres mètodes, alternativa i facturació
- Cerca sense documents — el mètode de coincidència de dades
- Mètodes de verificació d’identitat a la consola — activació de carteres per país