Primii pași

Fluxul integrării

Scenariul de succes al unei integrări iframe. Callback-ul este trimis înainte ca frontend-ul să fie notificat.

sequenceDiagram
participant U as Utilizator
participant W as Site-ul tău
participant WG as Wealth Reader Widget
participant API as Wealth Reader API
participant B as Instituția financiară
U->>W: Deschide aplicația
W->>WG: Introdu iframe cu operation_id
U->>WG: Alege entitatea și dă consimțământul
WG->>API: Solicită datele cu operation_id
API->>B: Cere detalii despre cont
B-->>API: Returnează date brute
API-->>WG: Returnează date normalizate
WG->>W: Trimite un POST către callback (operation_id + token + payload)
W-->>WG: Răspunde HTTP 200 și status ok
WG-->>W: Trimite postMessage flow completed
W-->>U: Afișează ecranul de succes

Cine face ce

Actor	Responsabilitate
Frontend-ul dumneavoastră	Generează un `operation_id` unic, încarcă widgetul și ascultă `postMessage`.
Widgetul	Afișează utilizatorului băncile, autentificarea, 2FA și erorile.
API-ul Wealth Reader	Comunică cu instituția și normalizează răspunsul.
Backend-ul dumneavoastră	Expune URL-ul de callback, răspunde `{"status":"ok"}` și stochează `operation_id`, `token` și payload.

Dacă ceva eșuează

Parolă greșită, 2FA sau o eroare a instituției: widgetul o gestionează împreună cu utilizatorul. Frontend-ul dumneavoastră poate primi un JSON de eroare prin postMessage; callback-ul nu este apelat până când citirea nu se termină cu succes.
Callback-ul dumneavoastră nu returnează 200 + {"status":"ok"}: utilizatorul nu vede succesul, iar frontend-ul nu primește flow completed.
Un token încetează să funcționeze (schimbare de parolă, 2FA nou): deschideți din nou widgetul transmițând acel token ca utilizatorul să se poată reautentifica.

Detaliile mesajelor și corpul callback-ului sunt pe paginile iframe.

Pasul următor

Dacă integrați prin iframe, continuați cu frontend și apoi cu backend. Dacă nu puteți îngloba un iframe, mergeți la OAuth.

Ultima actualizare 2026-08-24