Kom godt i gang
Indførelsen
Denne guide forklarer, hvordan man integrerer Wealth Reader: brugeren vælger sin bank, autentificerer, og dit system modtager de normaliserede data.
Eksempel på det endelige resultat: https://widget.wealthreader.com/demo-all/
Før du begynder
Du har brug for:
- Har gennemført kontoregistreringen og har en
api_key. - En onboarding-session med det tekniske team. Book din fra Støtte.
- Beslut dig for typen af integration (nedenfor).
- En URL HTTPS modtage callback, hvis du integrerer via iframe.
Vælg typen af integration
| Kriterier | Iframe (widget) | OAuth |
|---|---|---|
| Hvornår | Webapplikation, der kan indlejre en iframe | Native app, eller du kan ikke indlejre en iframe |
| Frontend | Du indlejrer widgetten på din side | Du omdirigerer brugeren til oauth.wealthreader.com |
| Data | De ankommer POST til din callback URL |
Du får dem ved at gennemføre udfordringen i /token/ |
| Start med | Iframe: frontend | OAuth: backend |
De fleste webklienter bruger iframe.
Programmerer du med en AI-assistent? Installer Wealth Reader færdighed i Claude Code, Codex, Cursor, Copilot eller Gemini CLI og genererer integrationen ved at følge denne guide.
Sådan fungerer det (iframe)
- Din side indlæser widgetten med en
operation_id, du genererer. - Brugeren vælger entiteten, giver samtykke og løser tofaktor-problemet om nødvendigt. Widgetten styrer disse trin.
- Wealth Reader henter dataene og gør to ting, i denne rækkefølge:
- På backend sender du hele JSON til den callback URL, du har sat op.
operation_idsendes i det svar, så du kan knytte det til din front-end operation. - På frontenden advarer iframen din side med
postMessage(flow completed), kun hvis callback svarede korrekt. Brug den til at lukke vælgeren eller vise en successkærm.
- På backend sender du hele JSON til den callback URL, du har sat op.
operation_id er broen mellem front og bagside. Uden den kan du ikke krydsreferere, hvad der skete i browseren, med de data, der ankommer til din server.
Den flow completed besked indeholder ikke bankdataene. Dataene rejser til callback. Hvis callback ikke svarer HTTP 200 med {"status":"ok"}, modtager fronten ikke flow completed.