Kom godt i gang

Integrationsflow

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

sequenceDiagram
participant Usuario
participant Web
participant Widget as Wealth Reader Widget
participant API as Wealth Reader API
participant Banco as Entidad Financiera
Usuario->>Web: Abre la aplicación
Web->>Widget: Carga el iframe con operation_id
Usuario->>Widget: Elige entidad y da consentimiento
Widget->>API: Solicita los datos con operation_id
API->>Banco: Consulta
Banco-->>API: Responde
API-->>Widget: Devuelve datos normalizados
Widget->>Web: POST al callback (operation_id + token + payload)
Web-->>Widget: HTTP 200 y status ok
Widget-->>Web: postMessage flow completed
Web-->>Usuario: Muestra finalización OK

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 2026-08-15