Saltar al contingut principal
Smart-ID i Mobile-ID permeten que els usuaris verifiquin la seva identitat aprovant una sol·licitud al seu telèfon. Fes servir la Smart-ID API o la Mobile-ID API per iniciar la verificació des de la teva pròpia aplicació sense un flux de treball. Tots dos mètodes també s’executen dins del pas de flux de treball de Verificació d’identitat de Didit, retornant un resultat de verificació de cartera amb garantia cryptographic. Per a la integració del flux de treball allotjat que es descriu a continuació, utilitza el mateix procés de creació de sessions i la mateixa integració de webhooks que per als altres fluxos de treball de Didit.
Smart-ID i Mobile-ID estan disponibles. Smart-ID admet Estònia, Letònia, Lituània i Bèlgica. Mobile-ID admet Estònia i Lituània. Selecciona les carteres que accepta el teu flux de treball per a cada país a la consola. Consulta cobertura de carteres i preus per veure la llista completa.

​
Països i requisits previs

La integració cobreix Smart-ID a Estònia (EST), Letònia (LVA), Lituània (LTU) i Bèlgica (BEL). Mobile-ID cobreix Estònia (EST) i Lituània (LTU); Mobile-ID no s’ofereix per a Letònia. Aquests codis de país descriuen les rutes integrades, no pas una promesa que cada ruta estigui activada al teu entorn. Per a Smart-ID, l’usuari necessita una identitat Smart-ID activa i apta, el seu codi d’identificació personal i accés a l’aplicació. Per a Mobile-ID, l’usuari necessita una identitat Mobile-ID activa, el seu codi d’identificació personal i el número de telèfon associat. Introdueix el número de telèfon de Mobile-ID en format internacional: +372 per a Estònia o +370 per a Lituània. El país seleccionat ha de coincidir amb la identitat que s’està utilitzant. Cap dels dos mètodes retorna una foto de retrat. Si el teu flux de treball requereix una selfie, mantén configurats per separat els passos apropiats de Prova de vida i Coincidència facial.

​
El que veu l’usuari

  1. L’usuari selecciona el seu país i tria Smart-ID o Mobile-ID d’entre les carteres que accepta el teu flux de treball.
  2. La sessió de verificació demana el codi d’identificació personal; Mobile-ID també demana el número de telèfon associat.
  3. La pàgina mostra un codi de comparació mentre la sol·licitud d’autenticació arriba al telèfon.
  4. L’usuari comprova que el codi del telèfon coincideixi amb el codi de la pàgina de verificació, i després aprova utilitzant el seu PIN al telèfon.
  5. Didit valida el resultat de la identitat signada i continua el flux de treball de verificació.
El formulari d’identitat i la pantalla del codi de comparació utilitzen el mateix disseny que els altres mètodes de verificació. Quan la personalització de marca blanca està activada, hereten els colors, la tipografia, l’estil dels botons i el logotip del client de la sessió, i romanen al domini de la sessió. Actualitzar la pàgina restableix el codi de comparació actiu sense iniciar una altra sol·licitud d’aprovació. L’usuari mai no introdueix el PIN de la seva cartera a la pàgina de verificació. Si els codis difereixen o l’usuari no ha iniciat la sol·licitud, l’hauria de cancel·lar. El flux del codi de comparació funciona amb un navegador d’escriptori o de telèfon i no requereix cap codi QR. La pàgina espera el resultat automàticament i ofereix una opció de cancel·lació. Una aprovació al telèfon encara ha de superar les comprovacions d’identitat i signatura abans que Didit consideri la verificació de la cartera com a satisfactòria.

​
Configurar el flux de treball

A la consola, obre el node Verificació d’identitat del teu flux de treball, tria Països i obre el país que vols configurar. A Carteres acceptades, selecciona les carteres disponibles i tria el comportament en cas d’error. Guarda i publica el flux de treball abans de crear una nova sessió. Consulta mètodes de Verificació d’identitat a la consola per veure la ruta completa a la consola.
El següent és un fragment de configuració de methods, no una sol·licitud completa de flux de treball. Fes-lo servir només quan tant smart_id com mobile_id estiguin marcats com a available per a Estònia al teu entorn. Una cartera no disponible rebutja el desat de tot el flux de treball.
L’array providers és una llista d’acceptació: els usuaris trien entre les carteres que conté, i l’ordre de l’array no estableix cap cartera preferida. Per a Lituània, fes servir LTU amb els mateixos identificadors de cartera quan tots dos estiguin disponibles. Per a Letònia o Bèlgica, fes servir LVA o BEL només amb smart_id, subjecte a la mateixa comprovació de disponibilitat. Els països omesos conserven el seu comportament de captura de documents per defecte existent. El contracte complet de configuració es troba a Configuracions de funcionalitats de flux de treball.

​
Llegir el resultat verificat

Llegeix la sessió completada mitjançant la API de decisió de sessió o la teva integració de webhooks. Una comprovació de cartera satisfactòria registra verification_method: "wallet", assurance: "cryptographic" i wallet_provider: "smart_id" o "mobile_id". L’objecte wallet_verification identifica la cartera, el país emissor, l’hora de verificació, el nivell de garantia i el veredicte de la signatura. El resultat de la verificació d’identitat exposa els camps normalitzats full_name i date_of_birth. Per a aquestes dues carteres, wallet_verification.attributes inclou given_name, family_name, birthdate i personal_code de la identitat validada. El país emissor identifica la ruta de la identitat; no estableix la nacionalitat de la persona. Didit retorna el veredicte de la signatura, no pas l’asserció signada subjacent. No es retorna cap foto de retrat ni el PIN de la cartera. A la consola, la targeta Credencial de la sessió mostra la cartera i la seva evidència verificada. Una comprovació de cartera satisfactòria completa el pas de Verificació d’identitat; les comprovacions posteriors del teu flux de treball continuen determinant la decisió final de la sessió. Consulta el model de dades de verificació d’identitat per conèixer els tipus de camps i la distinció entre el resultat d’una comprovació i la decisió global de la sessió.

​
Gestionar la cancel·lació i les fallades

Si un usuari cancel·la, esgota el temps d’espera o no pot completar l’autenticació, Didit aplica la configuració wallet.on_failure del país. fallback_to_document inicia la captura de documents quan està habilitada per a aquest país. decline rebutja el pas de Verificació d’identitat. Si la captura de documents està inhabilitada, no hi ha cap alternativa de document disponible. Només una comprovació de cartera completada i verificada comporta el càrrec de verificació de cartera. Els intents de cartera cancel·lats, caducats i fallits no en comporten. Una alternativa de document completada és una comprovació independent segons els preus de verificació de documents. Consulta la taula de preus de carteres per veure les tarifes publicades; un mètode sense una tarifa publicada no s’ha de considerar gratuït.

​
Provar abans de producció

Prova cada cartera i país que tinguis previst oferir en l’entorn on estiguin habilitats. Confirma que apareguin les carteres correctes, que el codi de comparació sigui visible, que l’aprovació faci continuar el flux de treball i que el resultat de la sessió contingui les proves esperades de la cartera. Comprova també la cancel·lació, la caducitat i el comportament alternatiu que hagis triat. Les simulacions en sandbox i les proves de preproducció són diferents de l’autenticació en producció. Una aprovació simulada és útil per comprovar la teva integració, però no demostra que una identitat real pugui autenticar-se en producció. Abans del desplegament, confirma la disponibilitat en producció a la consola i completa una verificació autoritzada amb un dispositiu real per a la ruta que tinguis previst utilitzar.

​
Altres carteres d’identitat digital

El catàleg de carteres d’identitat digital de Didit inclou la disponibilitat en producció i les properes carteres, incloent-hi la xarxa Finnish Trust Network, que està disponible, i les properes integracions de BankID i EUDI Wallet. El fet que una cartera estigui llistada, tingui un preu publicat o compti amb un formulari d’alta completat no habilita per si sol l’autenticació en producció. Utilitza el catàleg i la consola del teu entorn per determinar què pots activar avui. Consulta també Finnish Trust Network per a Finlàndia.
Darrera modificació el 7 de novembre del 2026