Kom i gang
Introduksjon
Denne guiden forklarer hvordan man integrerer Wealth Reader: brukeren velger sin bank, autentiserer, og systemet ditt mottar de normaliserte dataene.
Eksempel på sluttresultatet: https://widget.wealthreader.com/demo-all/
Før du begynner
Du trenger:
- Har fullført kontoregistreringen og har en
api_key. - En onboarding-økt med det tekniske teamet. Bestill din fra Støtte.
- Bestem deg for typen integrasjon (nedenfor).
- En URL HTTPS motta callback, hvis du integrerer via iframe.
Velg typen integrasjon
| Kriterier | Iframe (widget) | OAuth |
|---|---|---|
| Når | Nettapplikasjon som kan legge inn en iframe | Native app, eller du kan ikke legge inn en iframe |
| Frontend | Du legger inn widgeten på siden din | Du omdirigerer brukeren til oauth.wealthreader.com |
| Data | De kommer POST til din callback URL |
Du får dem ved å fullføre utfordringen i /token/ |
| Start med | Iframe: frontend | OAuth: backend |
De fleste webklienter bruker iframe.
Programmerer du med en AI-assistent? Installer Wealth Reader ferdighet i Claude Code, Codex, Cursor, Copilot eller Gemini CLI og genererer integrasjonen ved å følge denne veiledningen.
Hvordan det fungerer (iframe)
- Siden din laster widgeten med en
operation_iddu genererer. - Brukeren velger entiteten, gir samtykke, og løser tofaktoren om nødvendig. Widgeten håndterer disse trinnene.
- Wealth Reader henter dataene og gjør to ting, i denne rekkefølgen:
- Til backend sender Wealth Reader hele JSON til den callback URL-en du har satt opp.
operation_idsendes i det svaret slik at du kan knytte det til front-end-operasjonen din. - På frontend varsler iframen siden din med
postMessage(flow completed) bare hvis callback svarte riktig. Bruk den til å lukke velgeren eller vise en suksessskjerm.
- Til backend sender Wealth Reader hele JSON til den callback URL-en du har satt opp.
Den operation_id er broen mellom front og bakside. Uten den kan du ikke kryssjekke det som skjedde i nettleseren med dataene som kommer til serveren din.
Den flow completed meldingen inneholder ikke bankdataene. Dataene sendes til callback. Hvis callback ikke svarer HTTP 200 med {"status":"ok"}, mottar ikke fronten flow completed.