Aan de slag
Inleiding
Deze gids legt uit hoe je Wealth Readerintegreert: de gebruiker kiest zijn bank, authenticeert zich en je systeem ontvangt de genormaliseerde gegevens.
Voorbeeld van het eindresultaat: https://widget.wealthreader.com/demo-all/
Voordat je begint
Je hebt nodig:
- Heb de accountregistratie afgerond en heb een
api_key. - Een onboardingsessie met het technische team. Boek die van jou vanaf Ondersteuning.
- Bepaal het type integratie (hieronder).
- Een URL HTTPS de callbackontvangen, als je integreert via iframe.
Kies het type integratie
| Criteria | Iframe (widget) | OAuth |
|---|---|---|
| Wanneer | Webapplicatie die een iframe kan inbedden | Native app, of je kunt geen iframe inbedden |
| Frontend | Je embed de widget op je pagina | Je stuurt de gebruiker door naar oauth.wealthreader.com |
| Data | Ze komen POST aan op je callback URL |
Je krijgt ze door de uitdaging in /token/ te voltooien |
| Begin met | Iframe: frontend | OAuth: backend |
De meeste webclients gebruiken iframe.
Programmeer je met een AI-assistent? Installeer de Wealth Reader vaardigheid in Claude Code, Codex, Cursor, Copilot of Gemini CLI en genereert de integratie door deze gids te volgen.
Hoe het werkt (iframe)
- Je pagina laadt de widget met een
operation_iddie je genereert. - De gebruiker kiest de entiteit, geeft toestemming en lost de tweefactor-situatie indien nodig op. De widget beheert die stappen.
- Wealth Reader haalt de data op en doet twee dingen, in deze volgorde:
- Naar je backend stuurt Wealth Reader de volledige JSON naar de callback-URL die je hebt ingesteld. De
operation_idwordt meegestuurd zodat je de gegevens aan de operatie in je frontend kunt koppelen. - Aan de frontend waarschuwt het iframe je pagina met
postMessage(flow completed) alleen als de callback correct heeft gereageerd. Gebruik het om de selector te sluiten of een successcherm te tonen.
- Naar je backend stuurt Wealth Reader de volledige JSON naar de callback-URL die je hebt ingesteld. De
De operation_id is de brug tussen voor- en achterkant. Zonder die kunt u niet verwijzen wat er in de browser is gebeurd met de data die op uw server binnenkomt.
Het flow completed bericht bevat de bankgegevens niet. De gegevens reizen naar de callback. Als de callback niet reageert HTTP 200 met {"status":"ok"}, ontvangt de voorkant geen flow completed.