Ag tosú

Sreabhadh comhtháthaithe

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

sequenceDiagram
participant U as Úsáideoir
participant W as Do shuíomh gréasáin
participant WG as Wealth Reader Giuirléid
participant API as Wealth Reader API
participant B as Institiúid airgeadais
U->>W: Oscail an aip
W->>WG: Cuir isteach an iframe le operation_id
U->>WG: Roghnaigh an t-eintiteas agus tabhair toiliú
WG->>API: Iarr na sonraí le operation_id
API->>B: Iarr sonraí cuntais
B-->>API: Filleann sé sonraí amh
API-->>WG: Filleann sé sonraí normalaithe
WG->>W: Seol POST chuig an callback (operation_id + token + payload)
W-->>WG: Freagra HTTP 200 agus status ok
WG-->>W: Seol postMessage flow completed
W-->>U: Taispeáin an scáileán rathúlachta

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-24