Aloitus

Johdanto

Tämä opas selittää, miten Wealth Readerintegroidaan: käyttäjä valitsee pankkinsa, todentaa ja järjestelmäsi vastaanottaa normalisoidut tiedot.

Esimerkki lopputuloksesta: https://widget.wealthreader.com/demo-all/

Ennen kuin aloitat

Tarvitset:

Rekisteröity asiakastili ja käytettävissä oleva api_key.
Perehdytyssessio teknisen tiimin kanssa. Varaa omasi Tuki.
Päätä integraation tyypistä (alla).
URL HTTPS vastaanottaa callback, jos integroit sen iframen kautta.

Valitse integraation tyyppi

Kriteerit	Iframe (widget)	OAuth
Milloin	Web-sovellus, joka voi upottaa iframen	Natiivisovellus, tai et voi upottaa iframea
Frontend	Upotat widgetin sivullesi	Ohjaat käyttäjän `oauth.wealthreader.com`
Tiedot	Ne saapuvat `POST` callback URL-osoitteesi	Saat ne suorittamalla haasteen `/token/`
Aloita	Iframe: frontend	OAuth: backend

Useimmat web-asiakkaat käyttävät iframea.

Ohjelmoitko tekoälyavustajan kanssa? Asenna Wealth Reader taito Claude Code, Codex, Cursor, Copilot tai Gemini CLI ja generoi integraation noudattamalla tätä ohjetta.

Miten se toimii (iframe)

Sivusi lataa widgetin operation_id , jonka luot.
Käyttäjä valitsee pankin, antaa suostumuksensa ja suorittaa tarvittaessa kaksivaiheisen tunnistautumisen. Widget hallinnoi näitä vaiheita.
Wealth Reader saa tiedot ja tekee kaksi asiaa tässä järjestyksessä:
- Taustajärjestelmään Wealth Reader lähettää koko JSON-vastauksen määrittämääsi callback-URL-osoitteeseen. Mukana oleva operation_id yhdistää tiedot käyttöliittymän operaatioon.
- Käyttöliittymässä iframe ilmoittaa sivullesi postMessage (flow completed) vain, jos callback vastasi oikein. Käytä sitä valitsimen sulkemiseen tai onnistumisnäytön näyttämiseen.

operation_id on silta etu- ja takapuolen välillä. Ilman sitä et voi verrata selaimessa tapahtuneita tietoja palvelimellesi.

flow completed viesti ei sisällä pankkitietoja. Data kulkee callback. Jos callback ei vastaa HTTP 200 {"status":"ok"}, etuosa ei vastaanota flow completed.

Päivitetty viimeksi 2026-09-10