Primii pași
Introducere
Acest ghid explică cum să integrezi Wealth Reader: utilizatorul își alege banca, se autentifică, iar sistemul tău primește datele normalizate.
Exemplu de rezultat final: https://widget.wealthreader.com/demo-all/
Înainte să începi
Ai nevoie de:
- Am finalizat înregistrarea contului și am un
api_key. - O sesiune de integrare cu echipa tehnică. Rezervă-ți sesiunile de la Sprijin.
- Decideți asupra tipului de integrare (mai jos).
- Un URL HTTPS primi callback, dacă integrezi prin iframe.
Alege tipul de integrare
| Criterii | Iframe (widget) | OAuth |
|---|---|---|
| Când | Aplicație web care poate încorpora un iframe | Aplicație nativă, altfel nu poți încorpora un iframe |
| Frontend | Încorporezi widget-ul pe pagina ta | Redirecționezi utilizatorul către oauth.wealthreader.com |
| Date | Ele ajung POST la URL-ul tău callback |
Le obții completând provocarea în /token/ |
| Începe cu | Iframe: frontend | OAuth: backend |
Majoritatea clienților web folosesc iframe.
Programezi cu un asistent AI? Instalează Wealth Reader abilitate în Claude Code, Codex, Cursor, Copilot sau Gemini CLI și generează integrarea urmând acest ghid.
Cum funcționează (iframe)
- Pagina ta încarcă widget-ul cu un
operation_idpe care îl generezi tu. - Utilizatorul alege entitatea, își dă consimțământul și rezolvă problema cu doi factori dacă este necesar. Widget-ul gestionează acești pași.
- Wealth Reader obține datele și face două lucruri, în această ordine:
- Pe backend, trimite JSON completă către URL-ul callback pe care l-ai configurat.
operation_idcălătorește în acel răspuns, astfel încât îl poți asocia cu operațiunea ta de front-end. - Pe frontend, iframe-ul alertează pagina cu
postMessage(flow completed) doar dacă callback răspuns corect. Folosește-l pentru a închide selectorul sau pentru a afișa un ecran de succes.
- Pe backend, trimite JSON completă către URL-ul callback pe care l-ai configurat.
operation_id este puntea dintre față și spate. Fără ea, nu poți corela ce s-a întâmplat în browser cu datele care ajung pe serverul tău.
Mesajul flow completed nu conține datele băncii. Datele ajung la callback. Dacă callback nu răspunde HTTP 200 cu {"status":"ok"}, frontul nu primește flow completed.
Ultima actualizare