Aan de slag

Integratiestroom

Het succespad van een iframe-integratie. De callback wordt verzonden voordat de frontend wordt ingelicht.

sequenceDiagram
participant User as Gebruiker
participant Web
participant Widget as Wealth Reader Widget
participant API as Wealth Reader API
participant Bank as Financiële instelling
User->>Web: Opent de app
Web->>Widget: Laadt de iframe met operation_id
User->>Widget: Kiest een instelling en geeft toestemming
Widget->>API: Vraagt gegevens op met operation_id
API->>Bank: Opvraging
Bank-->>API: Antwoordt
API-->>Widget: Geeft genormaliseerde gegevens terug
Widget->>Web: POST naar callback (operation_id + token + payload)
Web-->>Widget: HTTP 200 en status ok
Widget-->>Web: postMessage flow completed
Web-->>User: Toont de geslaagde afronding

Wie doet wat

Actor	Verantwoordelijkheid
Uw frontend	Genereert een unieke `operation_id`, laadt de widget en luistert naar `postMessage`.
De widget	Toont banken, login, 2FA en fouten aan de gebruiker.
De Wealth Reader API	Praat met de instelling en normaliseert de response.
Uw backend	Stelt de callback-URL beschikbaar, antwoordt met `{"status":"ok"}` en slaat `operation_id`, `token` en payload op.

Als er iets misgaat

Verkeerd wachtwoord, 2FA of een fout van de instelling: de widget lost dat met de gebruiker op. Uw frontend kan een fout-JSON via postMessage ontvangen; de callback wordt niet aangeroepen totdat de uitlezing succesvol is afgerond.
Uw callback geeft geen 200 + {"status":"ok"} terug: de gebruiker ziet geen succes en de frontend ontvangt geen flow completed.
Een token werkt niet meer (wachtwoordwijziging, nieuwe 2FA): open de widget opnieuw en geef die token mee, zodat de gebruiker zich opnieuw kan authenticeren.

Details van de berichten en de callback-body staan op de iframe-pagina's.

Volgende stap

Als u via iframe integreert, ga verder met frontend en daarna backend. Als u geen iframe kunt insluiten, ga naar OAuth.

Laatst bijgewerkt 2026-08-15