Aan de slag

Integratiestroom

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

sequenceDiagram
participant U as Gebruiker
participant W as Uw website
participant WG as Wealth Reader Widget
participant API as Wealth Reader API
participant B as Financiële instelling
U->>W: Open de app
W->>WG: Plaats de iframe met operation_id
U->>WG: Kies de entiteit en geef toestemming
WG->>API: Vraag de gegevens aan bij operation_id
API->>B: Vraag om accountgegevens
B-->>API: Geeft ruwe data terug
API-->>WG: Geeft genormaliseerde data terug
WG->>W: Stuur een POST naar de callback (operation_id + token + payload)
W-->>WG: Beantwoord HTTP 200 en status ok
WG-->>W: Stuur postMessage flow completed
W-->>U: Toont het successcherm

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-24