Kom godt i gang
Introduktion
Denne vejledning forklarer, hvordan du integrerer Wealth Reader: brugeren vælger sin bank, autentificerer sig, og dit system modtager de normaliserede data.
Eksempel på det endelige resultat: https://widget.wealthreader.com/demo-all/
Før du går i gang
Du skal bruge:
- En gennemført tilmelding og en
api_key. - En onboarding-session med det tekniske team. Book din via Support.
- At beslutte integrationstypen (nedenfor).
- En HTTPS-URL, der modtager callbacken, hvis du integrerer via iframe.
Vælg integrationstype
| Kriterium | Iframe (widget) | OAuth |
|---|---|---|
| Hvornår | Webapp, der kan indlejre en iframe | Native app, eller du kan ikke indlejre en iframe |
| Frontend | Du indsætter widgetten på din side | Du omdirigerer brugeren til oauth.wealthreader.com |
| Data | Ankommer som et POST til din callback-URL |
Du henter dem ved at gennemføre challengen på /token/ |
| Start med | Iframe: frontend | OAuth: backend |
De fleste webkunder bruger iframe.
Sådan virker det (iframe)
- Din side indlæser widgetten med en
operation_id, som du selv genererer. - Brugeren vælger instituttet, giver samtykke og gennemfører tofaktorgodkendelse, hvis det er nødvendigt. Widgetten håndterer de trin.
- Wealth Reader henter dataene og gør to ting, i denne rækkefølge:
- På backend sender det den fulde JSON til den callback-URL, du har konfigureret.
operation_idfølger med i det svar, så du kan matche det med frontend-operationen. - På frontend giver iframen din side besked med
postMessage(flow completed) kun hvis callbacken lykkedes. Brug det til at lukke vælgeren eller vise en successkærm.
- På backend sender det den fulde JSON til den callback-URL, du har konfigureret.
operation_id er broen mellem frontend og backend. Uden den kan du ikke matche det, der skete i browseren, med de data, der lander på din server.
Beskeden flow completed indeholder ikke bankdata. Dataene går til callbacken. Hvis callbacken ikke svarer HTTP 200 med {"status":"ok"}, modtager frontenden ikke flow completed.
Senest opdateret