Saltar al contingut principal
Aquesta guia explica com incrustar el flux de verificació web de Didit dins d’un component WebView d’una aplicació mòbil nativa. No és el mateix que els SDK natius d’iOS, Android, React Native o Flutter. És una alternativa per a les plataformes que no poden usar un SDK natiu.

Prefereix sempre els SDK natius

Hi ha SDK natius disponibles per a iOS, Android, React Native i Flutter. Ofereixen un rendiment molt millor, una gestió de la càmera més completa, la lectura NFC de passaports i documents d’identitat, la integració biomètrica i una millor experiència d’usuari. Usa WebView només si no hi ha cap SDK natiu per a la teva plataforma.

SDK d'iOS

SDK natiu en Swift per a iOS 13+

SDK d'Android

SDK natiu en Kotlin per a Android 6.0+

SDK de React Native

API multiplataforma en TypeScript. Compatible amb Expo.

SDK de Flutter

API multiplataforma en Dart. Paquet de pub.dev.

Quan usar WebView

Usa la integració amb WebView només quan:
  • Desenvolupes en una plataforma sense SDK natiu (per exemple, Xamarin, Cordova o altres frameworks de nínxol)
  • Necessites un prototip ràpid o una prova de concepte abans d’integrar el SDK natiu
  • Estàs migrant des del web i vols un pont temporal cap a una integració nativa

Com funciona

1

Crea una sessió

El teu backend crida l’API de creació de sessió i rep una url allotjada.
2

Obre-la en un WebView

La teva aplicació carrega el url en un component WebView.
3

L'usuari completa la verificació

L’usuari segueix el flux de verificació dins del WebView.
4

Intercepta el callback

Quan acaba, el WebView navega cap a la teva URL de callback. La teva aplicació intercepta aquesta navegació i extreu el resultat.
5

Obtén els resultats complets mitjançant webhook

El teu backend rep les dades completes de la decisió mitjançant el webhook.

Crear una sessió

Abans d’obrir el flux de verificació, crea una sessió des del teu backend:
Resposta (201: el url incrusta el session_token de 12 caràcters, no el session_id):
Carrega el camp url en el WebView. Mai no el construeixis a partir de session_token manualment.

React Native

Instal·la el paquet de WebView:

Implementació

Demo de React Native

Exemple de verificació amb Expo i WebView

Flutter

Afegeix els paquets necessaris a pubspec.yaml:

Implementació

Demo de Flutter

Exemple de verificació amb WebView en Flutter

Configuració crítica

Agent d’usuari (obligatori)

Has d’establir un agent d’usuari genèric de mòbil perquè el WebView funcioni correctament:
Això garanteix l’accés correcte a la càmera, una renderització adequada de la interfície i una reproducció de contingut multimèdia òptima.

Configuració multimèdia (obligatòria)


Gestió del callback

Després de la verificació, el WebView redirigeix a la teva URL de callback amb paràmetres de consulta:
Per a una millor experiència d’usuari, usa un esquema d’URL personalitzat (per exemple, myapp://verification-complete) com a callback i gestiona’l com a enllaç profund a la teva aplicació.

Resolució de problemes

  1. Assegura’t que mediaPlaybackRequiresUserGesture sigui false
  2. Verifica que el sistema operatiu hagi concedit els permisos de càmera
  3. Comprova que la cadena de user agent estigui ben configurada
  1. Verifica que la URL de la sessió sigui vàlida i no hagi caducat
  2. Comprova la connectivitat a Internet
  3. Assegura’t que JavaScript estigui habilitat a la configuració del WebView
  1. Verifica que la teva URL de callback coincideixi amb la que vas definir en crear la sessió
  2. Comprova que el delegat o l’escoltador de navegació estigui configurat correctament
  3. Prova d’establir callback_method a "both" en crear la sessió

Darrera modificació el 7 de novembre del 2026