Primers passos
Introducció
Aquesta guia explica com integrar Wealth Reader: l'usuari tria el seu banc, s'autentica i el teu sistema rep les dades normalitzades.
Exemple del resultat final: https://widget.wealthreader.com/demo-all/
Abans de començar
Necessites:
- He completat el registre del compte i tinc una
api_key. - Una sessió d'incorporació amb l'equip tècnic. Reserva la teva a partir de Suport.
- Decideix el tipus d'integració (a continuació).
- Una URL HTTPS rebre el callback, si integres per iframe.
Tria el tipus d'integració
| Criteris | Iframe (widget) | OAuth |
|---|---|---|
| Quan | Aplicació web que pot incrustar un iframe | Aplicació nativa, o no pots incrustar un iframe |
| Frontend | Incorpores el widget a la teva pàgina | Redirigeixes l'usuari a oauth.wealthreader.com |
| Dades | Arriben POST a la teva URL callback |
Els obtens completant el repte a /token/ |
| Comença amb | Iframe: interfície | OAuth: backend |
La majoria de clients web utilitzen iframe.
Programes amb un assistent d'IA? Instal·la el Wealth Reader habilitat en Claude Code, Codex, Cursor, Copilot o Gemini CLI i genera la integració seguint aquesta guia.
Com funciona (iframe)
- La teva pàgina carrega el widget amb un
operation_idque tu generes. - L'usuari tria l'entitat, dóna el seu consentiment i resol el sistema de dos factors si cal. El widget gestiona aquests passos.
- Wealth Reader obté les dades i fa dues coses, en aquest ordre:
- Al backend, envia el JSON complet a l'URL callback que has configurat. El
operation_idviatja en aquesta resposta perquè puguis associar-lo amb la teva operació front-end. - A la interfície, l'iframe alerta la pàgina amb
postMessage(flow completed) només si el callback ha respost correctament. Utilitza'l per tancar el selector o mostrar una pantalla d'èxit.
- Al backend, envia el JSON complet a l'URL callback que has configurat. El
El operation_id és el pont entre la part frontal i posterior. Sense això, no pots creuar el que ha passat al navegador amb les dades que arriben al teu servidor.
El missatge de flow completed no conté les dades del banc. Les dades viatgen a la callback. Si el callback no respon HTTP 200 amb {"status":"ok"}, el front no rep flow completed.