Developers API & Widget
API Reference
DA

Kom godt i gang

Integrationsflow

Korrekt sti for en iframe-integration. callback sendes før underretning til frontend.

sequenceDiagram
participant U as Bruger
participant W as Din hjemmeside
participant WG as Wealth Reader Widget
participant API as API af Wealth Reader
participant B as Finansiel institution
U->>W: Åbn appen
W->>WG: Indsæt iframen med operation_id
U->>WG: Vælg enheden og giv samtykke
WG->>API: Anmod om dataene med operation_id
API->>B: Bed om kontooplysninger
B-->>API: Returnerer rådata
API-->>WG: Returnerer normaliserede 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 successkærmen

Hvem gør hvad

Skuespiller Ansvar
Din frontend Generer en unik operation_id , indlæs widgetten, og lyt til postMessage.
Widgetten Den viser banker, login, 2FA og fejl for brugeren.
API af Wealth Reader Tal med entiteten og normaliser svaret.
Din backend Eksponerer URL'en til callback, svarer {"status":"ok"} og gemmer operation_id, token og payload.

Hvis noget går galt

  • Forkert adgangskode, 2FA eller en entitetsfejl: widgetten løser dette sammen med brugeren. Din front kan modtage en fejl JSON for postMessage; callback kaldes ikke , før læsningen er færdig korrekt.
  • Din callback svarer ikke 200 + {"status":"ok"}: brugeren ser ikke succes, og fronten modtager ikke flow completed.
  • En token er ikke længere gyldig (adgangskodeændring, ny 2FA): genåbne widgetten ved at sende den token til brugeren til genautentificering.

Detaljerne i hver besked og brødteksten i callback findes på iframe-siderne.

Næste skridt

Hvis du integrerer med iframe, fortsætter du med frontend og så Backend. Hvis du ikke kan indlejre en iframe, så gå til OAuth.

Senest opdateret