Primii pași

Flux de integrare

Calea corectă a unei integrări iframe. Mesajul callback este trimis înainte de a notifica frontend-ul.

sequenceDiagram
participant U as Utilizator
participant W as Site-ul tău
participant WG as Wealth Reader Widget
participant API as API de Wealth Reader
participant B as Instituția financiară
U->>W: Deschide aplicația
W->>WG: Introdu iframe-ul 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ăspunsul HTTP 200 și status ok
WG-->>W: Trimite postMessage flow completed
W-->>U: Afișează ecranul de succes

Cine face ce

Actor	Răspundere
Partea ta frontală	Generează un `operation_id` unic, încarcă widget-ul și ascultă `postMessage`.
Widget-ul	Afișează băncile, autentificarea, 2FA și erorile utilizatorului.
API Wealth Reader	Vorbește cu entitatea și normalizează răspunsul.
Partea ta de spate	Expune URL-ul callback, răspunde `{"status":"ok"}` și salvează `operation_id`, `token` și payload.

Dacă ceva merge prost

Parolă incorectă, 2FA sau eroare de entitate: widget-ul rezolvă problema împreună cu utilizatorul. Frontul tău poate primi o eroare JSON pentru postMessage; callback nu este apelat până când citirea nu se termină bine.
callback ta nu răspunde 200 + {"status":"ok"}: utilizatorul nu vede succes, iar frontul nu primește flow completed.
Un token nu mai este valabil (schimbare de parolă, nou 2FA): redeschide widget-ul trecând acel token pentru ca utilizatorul să se reautentifice.

Detaliile fiecărui mesaj și corpul callback sunt pe paginile iframe.

Pasul următor

Dacă integrezi prin iframe, continuă prin Partea frontală și apoi Backend. Dacă nu poți încorpora un iframe, mergi la OAuth.

Ultima actualizare 2026-09-10