Primers passos
Introducció
Aquesta guia explica com integrar Wealth Reader: l’usuari tria el seu banc, s’autentica i el vostre sistema rep les dades normalitzades.
Exemple del resultat final: https://widget.wealthreader.com/demo-all/
Abans de començar
Necessiteu:
- Haver completat l’alta i disposar d’una
api_key. - Una sessió d’onboarding amb l’equip tècnic. Reserveu la vostra des de Suport.
- Decidir el tipus d’integració (més avall).
- Un URL HTTPS que rebi el callback, si integreu via iframe.
Trieu el tipus d’integració
| Criteri | Iframe (widget) | OAuth |
|---|---|---|
| Quan | Aplicació web que pot incrustar un iframe | Aplicació nativa, o no podeu incrustar un iframe |
| Frontend | Inseriu el widget a la vostra pàgina | Redirigiu l’usuari a oauth.wealthreader.com |
| Dades | Arriben amb un POST al vostre URL de callback |
Les obteniu en completar el challenge a /token/ |
| Comenceu per | Iframe: frontend | OAuth: backend |
La majoria de clients web fan servir l’iframe.
Com funciona (iframe)
- La vostra pàgina carrega el widget amb un
operation_idque genereu. - L’usuari tria l’entitat, dona el consentiment i completa l’autenticació de doble factor 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 de callback que heu configurat. L’
operation_idviatja en aquesta resposta perquè el pugueu associar a l’operació del frontend. - Al frontend, l’iframe notifica la vostra pàgina amb
postMessage(flow completed) només si el callback ha tingut èxit. Utilitzeu-lo per tancar el selector o mostrar una pantalla d’èxit.
- Al backend, envia el JSON complet a l’URL de callback que heu configurat. L’
L’operation_id és el pont entre el frontend i el backend. Sense ell no podeu creuar el que ha passat al navegador amb les dades que arriben al vostre servidor.
El missatge flow completed no conté les dades del banc. Les dades van al callback. Si el callback no respon HTTP 200 amb {"status":"ok"}, el frontend no rep flow completed.
Última actualització