Erste Schritte
Einleitung
Dieser Leitfaden erklärt, wie man Wealth Readerintegriert: Der Nutzer wählt seine Bank, authentifiziert sich, und Ihr System erhält die normalisierten Daten.
Beispiel für das Endergebnis: https://widget.wealthreader.com/demo-all/
Bevor du anfängst
Du brauchst:
- Eine abgeschlossene Registrierung und einen
api_key. - Eine Onboarding-Sitzung mit dem technischen Team. Buchen Sie Ihre von Unterstützung.
- Entscheiden Sie sich für die Art der Integration (siehe unten).
- Eine URL HTTPS die callbackerhalten, wenn man per iframe integriert.
Wählen Sie die Art der Integration
| Kriterien | Iframe (Widget) | OAuth |
|---|---|---|
| Wenn | Webanwendung, die ein iframe einbetten kann | Native-App, oder man kann keinen iframe einbetten. |
| Frontend | Du bettest das Widget auf deiner Seite ein | Du leitest den Nutzer auf oauth.wealthreader.com |
| Daten | Sie kommen POST zu deiner callback-URL an. |
Du bekommst sie, indem du die Herausforderung in /token/ abschließt |
| Fang an mit | Iframe: Frontend | OAuth: Backend |
Die meisten Webclients verwenden iframe.
Programmieren Sie mit einem KI-Assistenten? Installieren Sie das Wealth Reader Fähigkeit in Claude Code, Codex, Cursor, Copilot oder Gemini CLI und erzeugt die Integration durch Befolgung dieses Leitfadens.
Wie es funktioniert (iframe)
- Deine Seite lädt das Widget mit einem
operation_id, das du generierst. - Der Nutzer wählt die Entität, gibt seine Zustimmung und löst bei Bedarf das Zwei-Faktor-Problem. Das Widget verwaltet diese Schritte.
- Wealth Reader erhält die Daten und tut zwei Dinge, in folgender Reihenfolge:
- An Ihr Backend sendet Wealth Reader die vollständige JSON-Antwort an die konfigurierte Callback-URL. Die
operation_idwird dabei mitgesendet, damit Sie die Daten der Operation im Frontend zuordnen können. - Im Frontend benachrichtigt der iframe deine Seite nur mit
postMessage(flow completed), wenn der callback korrekt reagiert hat. Nutze es, um den Selektor zu schließen oder einen Erfolgsbildschirm anzuzeigen.
- An Ihr Backend sendet Wealth Reader die vollständige JSON-Antwort an die konfigurierte Callback-URL. Die
Die operation_id ist die Brücke zwischen Vorder- und Rückseite. Ohne sie kannst du das, was im Browser passiert ist, nicht mit den Daten abgleichen, die auf deinem Server ankommen.
Die flow completed Nachricht enthält keine Bankdaten. Die Daten gelangen an die callback. Wenn die callback nicht HTTP 200 mit {"status":"ok"}antwortet, erhält die Front keine flow completed.