Kom i gang
Introduksjon
Denne veiledningen forklarer hvordan du integrerer Wealth Reader: brukeren velger banken sin, autentiserer seg, og systemet ditt mottar de normaliserte dataene.
Eksempel på sluttresultatet: https://widget.wealthreader.com/demo-all/
Før du starter
Du trenger:
- En fullført registrering og en
api_key. - En onboarding-økt med det tekniske teamet. Bestill din via Support.
- Å bestemme integrasjonstypen (nedenfor).
- En HTTPS-URL som mottar callbacken, hvis du integrerer via iframe.
Velg integrasjonstype
| Kriterium | Iframe (widget) | OAuth |
|---|---|---|
| Når | Nettapp som kan bygge inn en iframe | Native app, eller du kan ikke bygge inn en iframe |
| Frontend | Du setter inn widgeten på siden din | Du omdirigerer brukeren til oauth.wealthreader.com |
| Data | Kommer som en POST til callback-URL-en din |
Du henter dem ved å fullføre challengen på /token/ |
| Start med | Iframe: frontend | OAuth: backend |
De fleste nettklienter bruker iframe.
Slik fungerer det (iframe)
- Siden din laster widgeten med en
operation_idsom du genererer. - Brukeren velger institusjonen, gir samtykke og fullfører tofaktorautentisering hvis det trengs. Widgeten tar seg av de stegene.
- Wealth Reader henter dataene og gjør to ting, i denne rekkefølgen:
- På backend sender det den fullstendige JSON-en til callback-URL-en du har konfigurert.
operation_idfølger med i det svaret, slik at du kan knytte det til frontend-operasjonen. - På frontend varsler iframen siden din med
postMessage(flow completed) bare hvis callbacken lyktes. Bruk det til å lukke velgeren eller vise en suksessskjerm.
- På backend sender det den fullstendige JSON-en til callback-URL-en du har konfigurert.
operation_id er broen mellom frontend og backend. Uten den kan du ikke knytte det som skjedde i nettleseren til dataene som kommer inn på serveren din.
Meldingen flow completed inneholder ikke bankdata. Dataene går til callbacken. Hvis callbacken ikke svarer HTTP 200 med {"status":"ok"}, mottar frontenden ikke flow completed.
Sist oppdatert