Aan de slag
Introductie
Deze gids legt uit hoe u Wealth Reader integreert: de gebruiker kiest een bank, authenticert zich, en uw systeem ontvangt de genormaliseerde gegevens.
Voorbeeld van het eindresultaat: https://widget.wealthreader.com/demo-all/
Voordat u begint
U heeft nodig:
- Een afgeronde registratie en een
api_key. - Een onboardingsessie met het technische team. Boek de uwe via Support.
- Een keuze voor het integratietype (hieronder).
- Een HTTPS-URL die de callback ontvangt, als u via iframe integreert.
Kies het integratietype
| Criterium | Iframe (widget) | OAuth |
|---|---|---|
| Wanneer | Webapp die een iframe kan insluiten | Native app, of u kunt geen iframe insluiten |
| Frontend | U plaatst de widget op uw pagina | U stuurt de gebruiker door naar oauth.wealthreader.com |
| Gegevens | Komen binnen als een POST naar uw callback-URL |
U verkrijgt ze door de challenge op /token/ af te ronden |
| Begin met | Iframe: frontend | OAuth: backend |
De meeste webklanten gebruiken de iframe.
Hoe het werkt (iframe)
- Uw pagina laadt de widget met een
operation_iddie u zelf genereert. - De gebruiker kiest de instelling, geeft toestemming en rondt indien nodig de tweefactorauthenticatie af. De widget verzorgt die stappen.
- Wealth Reader haalt de gegevens op en doet twee dingen, in deze volgorde:
- Op de backend stuurt het de volledige JSON naar de callback-URL die u hebt ingesteld. De
operation_idzit in die response, zodat u die kunt koppelen aan de frontend-operatie. - Op de frontend meldt de iframe uw pagina via
postMessage(flow completed) alleen als de callback is geslaagd. Gebruik dat om de kiezer te sluiten of een succes-scherm te tonen.
- Op de backend stuurt het de volledige JSON naar de callback-URL die u hebt ingesteld. De
De operation_id is de brug tussen frontend en backend. Zonder die waarde kunt u niet koppelen wat er in de browser gebeurde aan de gegevens die op uw server binnenkomen.
Het bericht flow completed bevat geen bankgegevens. De gegevens gaan naar de callback. Als de callback niet antwoordt met HTTP 200 en {"status":"ok"}, ontvangt de frontend geen flow completed.
Laatst bijgewerkt