Ag tosú

Sreabhadh comhtháthaithe

Conair rathúil comhtháthaithe iframe. Seoltar an callback sula gcuirtear an frontend ar an eolas.

sequenceDiagram
participant User
participant Web
participant Widget as Wealth Reader Widget
participant API as Wealth Reader API
participant Bank as Institiúid airgeadais
User->>Web: Osclaíonn an aip
Web->>Widget: Luchtaíonn an iframe le operation_id
User->>Widget: Roghnaíonn institiúid agus tugann toiliú
Widget->>API: Iarrann sonraí le operation_id
API->>Bank: Iarratas
Bank-->>API: Freagraíonn
API-->>Widget: Filleann sonraí normalaithe
Widget->>Web: POST chuig an callback (operation_id + token + payload)
Web-->>Widget: HTTP 200 agus status ok
Widget-->>Web: postMessage flow completed
Web-->>User: Taispeánann críochnú rathúil

Cé a dhéanann cad

Gníomhaí	Freagracht
Do frontend	Gineann `operation_id` uathúil, luchtaíonn an widget agus éisteann le `postMessage`.
An widget	Taispeánann bainc, logáil isteach, 2FA agus earráidí don úsáideoir.
API Wealth Reader	Labhraíonn leis an institiúid agus normalaíonn an freagra.
Do backend	Nochtann URL an callback, freagraíonn `{"status":"ok"}` agus stórálann `operation_id`, `token` agus an payload.

Má theipeann ar rud éigin

Pasfhocal mícheart, 2FA nó earráid ón institiúid: láimhseálann an widget é leis an úsáideoir. Féadfaidh do frontend JSON earráide a fháil trí postMessage; ní ghlaoitear an callback go dtí go n-éiríonn leis an léamh.
Mura bhfilleann do callback 200 + {"status":"ok"}: ní fheiceann an t-úsáideoir rath agus ní fhaigheann an frontend flow completed.
Má stopann token ag obair (athrú pasfhocail, 2FA nua): oscail an widget arís agus an token sin á chur ar aghaidh ionas gur féidir leis an úsáideoir fíordheimhniú arís.

Tá sonraí na dteachtaireachtaí agus corp an callback ar na leathanaigh iframe.

An chéad chéim eile

Má chomhtháthaíonn tú trí iframe, lean ar aghaidh leis an frontend agus ansin leis an backend. Mura féidir iframe a leabú, téigh chuig OAuth.

Nuashonraithe 2026-08-15