Primi passi
Introduzione
Questa guida spiega come integrare Wealth Reader: l'utente sceglie la propria banca, si autentica e il sistema riceve i dati normalizzati.
Esempio del risultato finale: https://widget.wealthreader.com/demo-all/
Prima di iniziare
Hai bisogno di:
- Ho completato la registrazione dell'account e ho una
api_key. - Una sessione di onboarding con il team tecnico. Prenota il tuo da Supporto.
- Decidete il tipo di integrazione (qui sotto).
- Un URL HTTPS ricevere il callback, se integri tramite iframe.
Scegli il tipo di integrazione
| Criteri | Iframe (widget) | OAuth |
|---|---|---|
| Quando | Applicazione web che può incorporare un iframe | App nativa, altrimenti non puoi incorporare un iframe |
| Frontend | Incorpori il widget nella tua pagina | Reindirizzi l'utente a oauth.wealthreader.com |
| Dati | Arrivano POST al tuo callback URL |
Li ottieni completando la sfida in /token/ |
| Inizia con | Iframe: frontend | OAuth: backend |
La maggior parte dei client web usa iframe.
Programmi con un assistente AI? Installa il Wealth Reader abilità in Claude Code, Codex, Cursor, Copilot o Gemini CLI e genera l'integrazione seguendo questa guida.
Come funziona (iframe)
- La tua pagina carica il widget con un
operation_idche generi tu. - L'utente sceglie l'entità, dà il consenso e risolve la questione a due fattori se necessario. Il widget gestisce questi passaggi.
- Wealth Reader ottiene i dati e fa due cose, in quest'ordine:
- Nel backend, invia l'intero JSON all'URL callback che hai impostato. Il
operation_idviaggia in quella risposta così puoi associarlo alla tua operazione front-end. - Nel frontend, l'iframe avvisa la pagina con
postMessage(flow completed) solo se il callback ha risposto correttamente. Usalo per chiudere il selettore o visualizzare una schermata di successo.
- Nel backend, invia l'intero JSON all'URL callback che hai impostato. Il
Il operation_id è il ponte tra frontale e retro. Senza di esso, non puoi incrociare ciò che è successo nel browser con i dati che arrivano sul tuo server.
Il messaggio flow completed non contiene i dati della banca. I dati viaggiano verso il callback. Se il callback non risponde HTTP 200 con {"status":"ok"}, il front non riceve flow completed.