Wann WebView verwendet werden sollte
Verwenden Sie die WebView-Integration nur, wenn:- Sie für eine Plattform ohne natives SDK entwickeln (z. B. Xamarin, Cordova oder andere Nischen-Frameworks)
- Sie einen schnellen Prototyp oder Machbarkeitsnachweis benötigen, bevor Sie das native SDK integrieren
- Sie von einer Webanwendung migrieren und eine temporäre Übergangslösung zu einer nativen Integration wünschen
Wie es funktioniert
1
Sitzung erstellen
Ihr Backend ruft die API zum Erstellen von Sitzungen auf und erhält eine gehostete
url.2
In WebView öffnen
Ihre App lädt die
url in einer WebView-Komponente.3
Benutzer schließt Verifizierung ab
Der Benutzer durchläuft den Verifizierungsflow innerhalb der WebView.
4
Callback abfangen
Nach Abschluss navigiert die WebView zu Ihrer Callback-URL. Ihre App fängt diese Navigation ab und extrahiert das Ergebnis.
5
Vollständige Ergebnisse per Webhook abrufen
Ihr Backend empfängt die vollständigen Entscheidungsdaten per Webhook.
Sitzung erstellen
Bevor Sie den Verifizierungsflow öffnen, erstellen Sie eine Sitzung über Ihr Backend:201 – die url enthält das 12-stellige session_token, nicht die session_id):
url in der WebView – erstellen Sie es niemals manuell aus session_token.
React Native
Installieren Sie das WebView-Paket:Implementierung
React Native-Demo
Verifizierungsbeispiel mit Expo + WebView
Flutter
Fügen Sie die erforderlichen Pakete zupubspec.yaml hinzu:
Implementierung
Flutter-Demo
Verifizierungsbeispiel mit Flutter WebView
Kritische Konfiguration
User-Agent (erforderlich)
Sie müssen einen generischen mobilen User-Agent festlegen, damit die WebView ordnungsgemäß funktioniert:Medieneinstellungen (erforderlich)
Callback verarbeiten
Nach der Verifizierung leitet die WebView mit Query-Parametern zu Ihrer Callback-URL weiter:Fehlerbehebung
Kamera funktioniert nicht
Kamera funktioniert nicht
- Stellen Sie sicher, dass
mediaPlaybackRequiresUserGestureauffalsegesetzt ist - Prüfen Sie, ob Kameraberechtigungen auf Betriebssystemebene erteilt wurden
- Stellen Sie sicher, dass der User-Agent-String korrekt gesetzt ist
Weißer Bildschirm oder Ladeprobleme
Weißer Bildschirm oder Ladeprobleme
- Überprüfen Sie, ob die Sitzungs-URL gültig und nicht abgelaufen ist
- Überprüfen Sie die Internetverbindung
- Stellen Sie sicher, dass JavaScript in den WebView-Einstellungen aktiviert ist
Callback wird nicht ausgelöst
Callback wird nicht ausgelöst
- Überprüfen Sie, ob Ihre Callback-URL mit der übereinstimmt, die Sie beim Erstellen der Sitzung angegeben haben
- Prüfen Sie, ob der Navigation-Delegate/-Listener ordnungsgemäß konfiguriert ist
- Versuchen Sie, beim Erstellen der Sitzung
callback_methodauf"both"zu setzen