Aan de slag

Integratieflow

Correct pad van een iframe-integratie. De callback wordt verzonden voordat de frontend wordt geïnformeerd.

sequenceDiagram
participant U as Gebruiker
participant W as Uw website
participant WG as Wealth Reader Widget
participant API as API van Wealth Reader
participant B as Financiële instelling
U->>W: Open de app
W->>WG: Voeg het iframe in 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: Antwoord HTTP 200 en status ok
WG-->>W: Stuur postMessage flow completed
W-->>U: Toont het successcherm

Wie doet wat

Onderdeel	Verantwoordelijkheid
Je frontend	Genereer een unieke `operation_id` , laad de widget en luister naar `postMessage`.
De widget	Het toont banken, inlog, 2FA en fouten aan de gebruiker.
De API van Wealth Reader	Praat met de entiteit en normaliseer de reactie.
Je backend	Biedt de callback-URL aan, reageert `{"status":"ok"}` en slaat `operation_id`, `token` en payloadop.

Als er iets misgaat

Onjuist wachtwoord, 2FA of een entiteitsfout: de widget lost dit op met de gebruiker. Je voorkant kan een foutmelding JSON voor postMessageontvangen; de callback wordt pas aangeroepen als de read goed is afgerond.
Je callback reageert niet 200 + {"status":"ok"}: de gebruiker ziet geen succes en de voorkant ontvangt geen flow completed.
Een token is niet langer geldig (wachtwoordwijziging, nieuwe 2FA): open de widget opnieuw door die token door te geven zodat de gebruiker opnieuw kan authenticeren.

De details van elk bericht en de inhoud van de callback staan op de iframe-pagina's.

Volgende stap

Als je integreert via iframe, ga dan door frontend en dan Backend. Als je geen iframe kunt inbedden, ga dan naar OAuth.

Laatst bijgewerkt 2026-09-10