Primi passi
Introduzione
Questa guida spiega come integrare Wealth Reader: l’utente sceglie la propria banca, si autentica e il vostro sistema riceve i dati normalizzati.
Esempio del risultato finale: https://widget.wealthreader.com/demo-all/
Prima di iniziare
Vi serve:
- Una registrazione completata e una
api_key. - Una sessione di onboarding con il team tecnico. Prenotatela da Supporto.
- Decidere il tipo di integrazione (più sotto).
- Un URL HTTPS che riceva il callback, se integrate via iframe.
Scegliete il tipo di integrazione
| Criterio | Iframe (widget) | OAuth |
|---|---|---|
| Quando | Applicazione web che può incorporare un iframe | App nativa, oppure non potete incorporare un iframe |
| Frontend | Inserite il widget nella vostra pagina | Reindirizzate l’utente a oauth.wealthreader.com |
| Dati | Arrivano con un POST al vostro URL di callback |
Li ottenete completando la challenge su /token/ |
| Iniziate da | Iframe: frontend | OAuth: backend |
La maggior parte dei clienti web usa l’iframe.
Come funziona (iframe)
- La vostra pagina carica il widget con un
operation_idche generate voi. - L’utente sceglie l’istituto, dà il consenso e completa l’autenticazione a due fattori se necessario. Il widget gestisce questi passaggi.
- Wealth Reader recupera i dati e fa due cose, in questo ordine:
- Sul backend, invia il JSON completo all’URL di callback che avete configurato. L’
operation_idviaggia in quella risposta così potete associarlo all’operazione del frontend. - Sul frontend, l’iframe notifica la vostra pagina con
postMessage(flow completed) solo se il callback è andato a buon fine. Usatelo per chiudere il selettore o mostrare una schermata di successo.
- Sul backend, invia il JSON completo all’URL di callback che avete configurato. L’
L’operation_id è il ponte tra frontend e backend. Senza di esso non potete far corrispondere ciò che è successo nel browser con i dati che arrivano sul vostro server.
Il messaggio flow completed non contiene i dati bancari. I dati vanno al callback. Se il callback non risponde HTTP 200 con {"status":"ok"}, il frontend non riceve flow completed.
Ultimo aggiornamento