Ag tosú
Réamhrá
Míníonn an treoir seo conas Wealth Reader a chomhtháthú: roghnaíonn an t-úsáideoir a bhanc, déanann sé fíordheimhniú, agus faigheann do chóras na sonraí normalaithe.
Sampla den toradh deiridh: https://widget.wealthreader.com/demo-all/
Sula dtosaíonn tú
Teastaíonn uait:
- Clárú críochnaithe agus
api_key. - Seisiún ionduchtúcháin leis an bhfoireann theicniúil. Cuir an ceann agatsa in áirithe ó Thacaíocht.
- Cinneadh a dhéanamh ar an gcineál comhtháthaithe (thíos).
- URL HTTPS a fhaigheann an callback, má chomhtháthaíonn tú trí iframe.
Roghnaigh an cineál comhtháthaithe
| Critéar | Iframe (widget) | OAuth |
|---|---|---|
| Cathain | Aip ghréasáin ar féidir iframe a leabú inti | Aip dhúchais, nó ní féidir leat iframe a leabú |
| Frontend | Cuireann tú an widget isteach ar do leathanach | Atreoraíonn tú an t-úsáideoir chuig oauth.wealthreader.com |
| Sonraí | Tagann siad mar POST chuig URL an callback agat |
Faigheann tú iad tríd an dúshlán ag /token/ a chur i gcrích |
| Tosaigh le | Iframe: frontend | OAuth: backend |
Úsáideann formhór na gcliant gréasáin an iframe.
Conas a oibríonn sé (iframe)
- Luchtaíonn do leathanach an widget le
operation_ida ghineann tú. - Roghnaíonn an t-úsáideoir an institiúid, tugann toiliú agus déanann fíordheimhniú dhá fhachtóir más gá. Láimhseálann an widget na céimeanna sin.
- Faigheann Wealth Reader na sonraí agus déanann sé dhá rud, san ord seo:
- Ar an backend, seolann sé an JSON iomlán chuig URL an callback a chumraigh tú. Téann an
operation_idsa fhreagra sin ionas gur féidir leat é a mheaitseáil leis an oibríocht frontend. - Ar an frontend, cuireann an iframe do leathanach ar an eolas le
postMessage(flow completed) ach amháin má d’éirigh leis an callback. Úsáid é sin chun an roghnóir a dhúnadh nó scáileán ratha a thaispeáint.
- Ar an backend, seolann sé an JSON iomlán chuig URL an callback a chumraigh tú. Téann an
Is é an operation_id an droichead idir an frontend agus an backend. Gan é ní féidir leat an méid a tharla sa bhrabhsálaí a mheaitseáil leis na sonraí a thagann chuig do fhreastalaí.
Níl na sonraí bainc sa teachtaireacht flow completed. Téann na sonraí chuig an callback. Mura bhfreagraíonn an callback HTTP 200 le {"status":"ok"}, ní fhaigheann an frontend flow completed.
Nuashonraithe