Primii pași

Introducere

Acest ghid explică cum să integrați Wealth Reader: utilizatorul își alege banca, se autentifică, iar sistemul dumneavoastră primește datele normalizate.

Exemplu de rezultat final: https://widget.wealthreader.com/demo-all/

Înainte de a începe

Aveți nevoie de:

Înregistrare finalizată și un api_key.
O sesiune de onboarding cu echipa tehnică. Rezervați-o din Suport.
Să decideți tipul de integrare (mai jos).
Un URL HTTPS care primește callback-ul, dacă integrați prin iframe.

Alegeți tipul de integrare

Criteriu	Iframe (widget)	OAuth
Când	Aplicație web care poate îngloba un iframe	Aplicație nativă sau nu puteți îngloba un iframe
Frontend	Inserați widgetul în pagina dumneavoastră	Redirecționați utilizatorul către `oauth.wealthreader.com`
Date	Sosesc ca `POST` la URL-ul de callback	Le obțineți finalizând challenge-ul la `/token/`
Începeți cu	Iframe: frontend	OAuth: backend

Majoritatea clienților web folosesc iframe-ul.

Cum funcționează (iframe)

Pagina dumneavoastră încarcă widgetul cu un operation_id pe care îl generați.
Utilizatorul alege instituția, își dă consimțământul și completează autentificarea în doi factori dacă este nevoie. Widgetul gestionează acești pași.
Wealth Reader preia datele și face două lucruri, în această ordine:
- Pe backend, trimite JSON-ul complet la URL-ul de callback pe care l-ați configurat. operation_id circulă în acel răspuns ca să îl puteți asocia cu operațiunea din frontend.
- Pe frontend, iframe-ul notifică pagina cu postMessage (flow completed) doar dacă callback-ul a reușit. Folosiți-l pentru a închide selectorul sau a afișa un ecran de succes.

operation_id este puntea dintre frontend și backend. Fără el nu puteți potrivi ce s-a întâmplat în browser cu datele care ajung pe serverul dumneavoastră.

Mesajul flow completed nu conține datele bancare. Datele merg la callback. Dacă callback-ul nu răspunde HTTP 200 cu {"status":"ok"}, frontend-ul nu primește flow completed.

Ultima actualizare 2026-08-14