Developers API & Widget
API Reference
GA

Ag tosú

Sreabhadh Comhtháthaithe

Conair cheart comhtháthú iframe. Seoltar an callback sula dtabharfar fógra don frontend.

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 API Wealth Reader
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

Aisteoir Dliteanas
Do chéadan Cruthaigh operation_id uathúil, luchtaigh an ghiuirléid, agus éist le postMessage.
An ghiuirléid Taispeánann sé bainc, logáil isteach, 2FA agus earráidí don úsáideoir.
An API Wealth Reader Labhair leis an eintiteas agus normalaigh an fhreagairt.
Do inneall Nochtann sé URL callback, freagraíonn sé {"status":"ok"} , agus sábhálann sé operation_id, token , agus payload.

Má théann rud éigin mícheart

  • Focal faire mícheart, 2FA, nó earráid aonáin: réitíonn an ghiuirléid é seo leis an úsáideoir. Is féidir le do tosaigh JSON earráide a fháil le haghaidh postMessage; ní ghlaonn an callback go dtí go gcríochnaíonn an léamh go maith.
  • Ní fhreagraíonn do callback 200 + {"status":"ok"}: ní fheiceann an t-úsáideoir rath agus ní fhaigheann an tosaigh flow completed.
  • Níl token bailí a thuilleadh (athrú pasfhocal, 2FA nua): oscail an ghiuirléid arís tríd an token sin a rith don úsáideoir chun athfhíordheimhniú.

Tá mionsonraí gach teachtaireachta agus corp na callback ar na leathanaigh iframe.

An chéad chéim eile

Má chomhtháthaíonn tú le iframe, lean ar aghaidh ag Oscail Agus ansin Inneall. Mura féidir leat iframe a leabú, téigh go dtí OAuth.

Nuashonraithe