Aloitus

Johdanto

Tämä opas kertoo, miten Wealth Reader integroidaan: käyttäjä valitsee pankkinsa, tunnistautuu, ja järjestelmäsi vastaanottaa normalisoidut tiedot.

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

Ennen kuin aloitat

Tarvitset:

Valmiin rekisteröitymisen ja api_key-avaimen.
Perehdytysistunnon teknisen tiimin kanssa. Varaa omasi Tuesta.
Päätöksen integraatiotyypistä (alla).
HTTPS-osoitteen, joka vastaanottaa callbackin, jos integroit iframe-upotuksella.

Valitse integraatiotyyppi

Kriteeri	Iframe (widget)	OAuth
Milloin	Verkkosovellus, johon voi upottaa iframen	Natiivisovellus tai iframea ei voi upottaa
Frontend	Upotat widgetin sivullesi	Ohjaat käyttäjän osoitteeseen `oauth.wealthreader.com`
Data	Saapuu `POST`-pyyntönä callback-osoitteeseesi	Saat ne suorittamalla challengen osoitteessa `/token/`
Aloita tästä	Iframe: frontend	OAuth: backend

Useimmat verkkoasiakkaat käyttävät iframea.

Miten se toimii (iframe)

Sivusi lataa widgetin itse luomallasi operation_id-tunnisteella.
Käyttäjä valitsee laitoksen, antaa suostumuksen ja suorittaa kaksivaiheisen tunnistautumisen tarvittaessa. Widget hoitaa nämä vaiheet.
Wealth Reader hakee tiedot ja tekee kaksi asiaa tässä järjestyksessä:
- Backendissä se lähettää koko JSONin määrittämääsi callback-osoitteeseen. operation_id kulkee vastauksessa, jotta voit yhdistää sen frontend-operaatioon.
- Frontendissä iframe ilmoittaa sivullesi postMessage-viestillä (flow completed) vain, jos callback onnistui. Käytä sitä sulkeaksesi valitsimen tai näyttääksesi onnistumisnäytön.

operation_id on silta frontendin ja backendin välillä. Ilman sitä et voi yhdistää selaimessa tapahtunutta palvelimelle saapuvaan dataan.

flow completed -viesti ei sisällä pankkidataa. Data menee callbackiin. Jos callback ei vastaa HTTP-koodilla 200 ja sisällöllä {"status":"ok"}, frontend ei saa flow completed -viestiä.

Päivitetty viimeksi 2026-08-14