Kom i gang

Integrasjonsflyt

Korrekt vei for en iframe-integrasjon. callback sendes før frontenden varsles.

sequenceDiagram
participant U as Bruker
participant W as Nettstedet ditt
participant WG as Wealthreader Widget
participant API as API av Wealthreader
participant B as Finansinstitusjon
U->>W: Åpne appen
W->>WG: Sett inn i-rammen 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

Skuespiller	Ansvar
Frontenden din	Generer en unik `operation_id` , last inn widgeten, og lytt til `postMessage`.
Widgeten	Den viser banker, innlogging, 2FA og feil til brukeren.
API av Wealthreader	Snakk med entiteten og normaliser responsen.
Din backend	Eksponerer URL-en til callback, svarer `{"status":"ok"}` , og lagrer `operation_id`, `token` og payload.

Hvis noe går galt

Feil passord, 2FA eller en enhetsfeil: widgeten løser dette med brukeren. Fronten din kan motta en feil JSON for postMessage; callback kalles ikke før lesingen er ferdig.
Din callback svarer ikke 200 + {"status":"ok"}: brukeren ser ikke suksess og fronten mottar ikke flow completed.
En token er ikke lenger gyldig (passordendring, ny 2FA): åpne widgeten på nytt ved å sende den token for brukeren å autentisere på nytt.

Detaljene i hver melding og hoveddelen av callback finnes på iframe-sidene.

Neste steg

Hvis du integrerer med iframe, fortsett med frontend og så Backend. Hvis du ikke kan legge inn en iframe, gå til OAuth.

Sist oppdatert 2026-11-08