> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Smart-ID i Mobile-ID: guia d'integració

> Configura la verificació d'identitat amb Smart-ID i Mobile-ID a Didit: cobertura per països, codis de control, atributs verificats i fallback.

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](https://docs.didit.me/ca/api-reference/digital-id-wallets/smart-id.md) o la [Mobile-ID API](https://docs.didit.me/ca/api-reference/digital-id-wallets/mobile-id.md) 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.

> [!NOTE]
>
> **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](https://docs.didit.me/ca/core-technology/id-verification/digital-id-wallets.md#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](https://docs.didit.me/ca/core-technology/liveness/overview.md) i [Coincidència facial](https://docs.didit.me/ca/core-technology/face-match/overview.md).

## 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](https://docs.didit.me/ca/console/id-verification-methods.md#activa-smart-id-o-mobile-id) per veure la ruta completa a la consola.

> [!WARNING]
>
> 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.

```json theme={null}
{
  "EST": {
    "document": { "enabled": true },
    "wallet": {
      "enabled": true,
      "providers": ["smart_id", "mobile_id"],
      "on_failure": "fallback_to_document"
    }
  }
}
```

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](https://docs.didit.me/ca/management-api/workflows/feature-configs.md#ocr-/-verificació-d’identitat).

## Llegir el resultat verificat

Llegeix la sessió completada mitjançant la [API de decisió de sessió](https://docs.didit.me/ca/sessions-api/retrieve-session.md) o la teva [integració de webhooks](https://docs.didit.me/ca/integration/webhooks.md).
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](https://docs.didit.me/ca/reference/data-models.md#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](https://docs.didit.me/ca/getting-started/pricing.md).
Consulta la [taula de preus de carteres](https://docs.didit.me/ca/core-technology/id-verification/digital-id-wallets.md#preus) 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](https://docs.didit.me/ca/core-technology/id-verification/digital-id-wallets.md) 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](https://docs.didit.me/ca/core-technology/id-verification/finnish-trust-network.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.