Developers API & Widget
API Reference
DA

Kom godt i gang

Integrationsflow

Korrekt sti for en iframe-integration. Callbacken sendes før den giver besked til frontend.

sequenceDiagram
participant U as Bruger
participant W as Din hjemmeside
participant WG as Wealth Reader Widget
participant API as Wealth Reader API
participant B as Finansiel institution
U->>W: Åbn appen
W->>WG: Indsæt iframe 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 operation_id en, indlæs widgetten, og lyt til postMessage.
Widgetten Den viser banker, login, 2FA og fejl for brugeren.
Wealth Reader API Tal med entiteten og normaliser svaret.
Din backend Eksponerer callback-URL'en, svarer {"status":"ok"} og gemmer operation_id samt token payload.

Hvis noget går galt

  • Forkert adgangskode, 2FA eller en entitetsfejl: widgetten løser dette med brugeren. Din front kan modtage en fejl-JSON for postMessage; callbacken kaldes ikke, før læsningen er færdig med succes.
  • Din callback svarer 200 ikke + {"status":"ok"}: brugeren ser ikke succes, og fronten modtager flow completedikke .
  • A token cease to be valid (adgangskodeændring, ny 2FA): genåben widgetten ved at sende den, token så brugeren kan genautentificere.

Detaljerne for hver besked og callback-kroppen findes på iframe-siderne.

Næste skridt

Hvis du integrerer via iframe, så gå gennem frontend ] og derefter backend. Hvis du ikke kan indlejre en iframe, så gå til OAuth.

Senest opdateret