Kom i gang

Integrasjonsflyt

Standardflyten i en iframe-integrasjon. Callbacken sendes før frontenden varsles.

sequenceDiagram
participant U as Bruker
participant W as Nettstedet ditt
participant WG as Wealth Reader Widget
participant API as Wealth Reader API
participant B as Finansinstitusjon
U->>W: Åpne appen
W->>WG: Sett inn iframe med operation_id
U->>WG: Velg enheten og gi samtykke
WG->>API: Be om dataene hos operation_id
API->>B: Be om kontodetaljer
B-->>API: Returnerer rådata
API-->>WG: Returnerer normaliserte data
WG->>W: Send en POST til callback (operation_id + token + payload)
W-->>WG: Svar HTTP 200 og status ok
WG-->>W: Send postMessage flow completed
W-->>U: Viser suksessskjermen

Hvem gjør hva

Aktør	Ansvar
Din frontend	Genererer en unik `operation_id`, laster widgeten og lytter etter `postMessage`.
Widgeten	Viser banker, innlogging, 2FA og feil for brukeren.
Wealth Reader API	Snakker med institusjonen og normaliserer svaret.
Din backend	Eksponerer callback-URL-en, svarer `{"status":"ok"}` og lagrer `operation_id`, `token` og payload.

Hvis noe feiler

Feil passord, 2FA eller en institusjonsfeil: widgeten håndterer det med brukeren. Frontenden din kan motta en feil-JSON via postMessage; callbacken kalles ikke før lesingen er fullført.
Callbacken din returnerer ikke 200 + {"status":"ok"}: brukeren ser ikke suksess, og frontenden mottar ikke flow completed.
Et token slutter å virke (passordendring, ny 2FA): åpne widgeten på nytt og send med det token, slik at brukeren kan autentisere seg på nytt.

Detaljer om meldingene og callback-bodyen står på iframe-sidene.

Neste steg

Hvis du integrerer via iframe, fortsett med frontend og deretter backend. Hvis du ikke kan bygge inn en iframe, gå til OAuth.

Sist oppdatert 2026-08-24