Aloitus

Integraatiovirta

iframe-integraation oikea polku. callback lähetetään ennen kuin frontendille ilmoitetaan.

sequenceDiagram
participant U as Käyttäjä
participant W as Verkkosivustosi
participant WG as Wealth Reader Widget
participant API as API Wealth Reader
participant B as Rahoituslaitos
U->>W: Avaa sovellus
W->>WG: Aseta iframe operation_id
U->>WG: Valitse toimija ja anna suostumus
WG->>API: Pyydä tiedot operation_id
API->>B: Kysy tilitietoja
B-->>API: Raakadatan palautus
API-->>WG: Palauttaa normalisoidut tiedot
WG->>W: Lähetä POST callback :lle (operation_id + token + payload)
W-->>WG: Vastaus HTTP 200 ja status ok
WG-->>W: Lähetä postMessage flow completed
W-->>U: Näyttää onnistumisnäytön

Kuka tekee mitä

Toimija	Vastuu
Etuosasi	Luo ainutlaatuinen `operation_id` , lataa widget ja kuuntele `postMessage`.
Widget	Se näyttää käyttäjälle pankit, kirjautumisen, 2FA:n ja virheet.
API Wealth Reader	Ottaa yhteyden pankkiin ja normalisoi vastauksen.
Taustajärjestelmäsi	Paljastaa callback:n URL-osoitteen, vastaa `{"status":"ok"}` ja tallentaa `operation_id`, `token` ja payload.

Jos jokin menee pieleen

Väärä salasana, kaksivaiheinen tunnistautuminen (2FA) tai entiteettivirhe: widget ratkaisee tämän käyttäjän kanssa. Etuosasi voi saada virheilmoituksen JSON postMessage; callback ei kutsuta ennen kuin luku on hyvin suoritettu.
Sinun callback ei vastaa 200 + {"status":"ok"}: käyttäjä ei näe menestystä eikä etu saa flow completed.
token ei enää ole voimassa (salasanan vaihto, uusi 2FA): avaa widget uudelleen antamalla käyttäjälle token todennuksen uudelleen.

Jokaisen viestin yksityiskohdat ja callback runko löytyvät iframe-sivuilta.

Seuraava askel

Jos integroit iframen kautta, jatka frontend ja sitten Taustajärjestelmä. Jos et voi upottaa iframea, mene kohtaan OAuth.

Päivitetty viimeksi 2026-09-10