Quando usare WebView
Usa l’integrazione WebView solo quando:- Stai sviluppando su una piattaforma senza SDK nativo (ad esempio Xamarin, Cordova o altri framework di nicchia)
- Ti serve un prototipo rapido o una prova di concetto prima di integrare l’SDK nativo
- Stai migrando dal web e vuoi un ponte temporaneo verso un’integrazione nativa
Come funziona
1
Crea una sessione
Il tuo backend chiama la API di creazione della sessione e riceve un
url ospitato.2
Apri nella WebView
La tua app carica l’
url in un componente WebView.3
L'utente completa la verifica
L’utente percorre il flusso di verifica all’interno della WebView.
4
Intercetta il callback
Al termine, la WebView passa al tuo URL di callback. La tua app intercetta questa navigazione ed estrae il risultato.
5
Ottieni i risultati completi tramite webhook
Il tuo backend riceve i dati completi della decisione tramite webhook.
Creare una sessione
Prima di aprire il flusso di verifica, crea una sessione dal tuo backend:201: l’url incorpora il session_token a 12 caratteri, non il session_id):
url nella WebView: non costruirlo mai a partire da session_token manualmente.
React Native
Installa il pacchetto WebView:Implementazione
Demo React Native
Esempio di verifica con Expo + WebView
Flutter
Aggiungi i pacchetti richiesti apubspec.yaml:
Implementazione
Demo Flutter
Esempio di verifica con WebView in Flutter
Configurazione critica
User agent (obbligatorio)
Devi impostare uno user agent mobile generico affinché la WebView funzioni correttamente:Impostazioni multimediali (obbligatorie)
Gestire il callback
Al termine della verifica, la WebView reindirizza al tuo URL di callback con parametri di query:Risoluzione dei problemi
La fotocamera non funziona
La fotocamera non funziona
- Assicurati che
mediaPlaybackRequiresUserGesturesiafalse - Verifica che le autorizzazioni della fotocamera siano concesse a livello di sistema operativo
- Controlla che la stringa dello user agent sia impostata correttamente
Schermata bianca o problemi di caricamento
Schermata bianca o problemi di caricamento
- Verifica che l’URL della sessione sia valido e non scaduto
- Controlla la connettività internet
- Assicurati che JavaScript sia abilitato nelle impostazioni della WebView
Il callback non viene attivato
Il callback non viene attivato
- Verifica che l’URL di callback corrisponda a quello impostato al momento della creazione della sessione
- Controlla che il delegate o il listener di navigazione sia configurato correttamente
- Prova a impostare
callback_methodsu"both"quando crei la sessione