Erste Schritte
Einführung
Dieser Leitfaden erklärt, wie Sie Wealth Reader integrieren: 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 Sie beginnen
Sie benötigen:
- Eine abgeschlossene Registrierung und einen
api_key. - Eine Onboarding-Sitzung mit dem technischen Team. Buchen Sie Ihre Sitzung unter Support.
- Eine Entscheidung für die Integrationsart (siehe unten).
- Eine HTTPS-URL, die den Callback empfängt, wenn Sie über iframe integrieren.
Integrationsart wählen
| Kriterium | Iframe (Widget) | OAuth |
|---|---|---|
| Wann | Webanwendung, die ein iframe einbetten kann | Native App oder Sie können kein iframe einbetten |
| Frontend | Sie fügen das Widget auf Ihrer Seite ein | Sie leiten den Nutzer zu oauth.wealthreader.com um |
| Daten | Treffen als POST an Ihrer Callback-URL ein |
Sie erhalten sie, indem Sie die Challenge unter /token/ abschließen |
| Beginnen Sie mit | Iframe: Frontend | OAuth: Backend |
Die meisten Web-Kunden nutzen das iframe.
So funktioniert es (iframe)
- Ihre Seite lädt das Widget mit einer von Ihnen erzeugten
operation_id. - Der Nutzer wählt das Institut, erteilt die Einwilligung und schließt bei Bedarf die Zwei-Faktor-Authentifizierung ab. Das Widget übernimmt diese Schritte.
- Wealth Reader holt die Daten und macht zwei Dinge, in dieser Reihenfolge:
- Im Backend sendet es das vollständige JSON an die von Ihnen konfigurierte Callback-URL. Die
operation_idist in dieser Antwort enthalten, damit Sie sie der Frontend-Operation zuordnen können. - Im Frontend benachrichtigt das iframe Ihre Seite per
postMessage(flow completed) nur, wenn der Callback erfolgreich war. Nutzen Sie das, um die Auswahl zu schließen oder einen Erfolgsbildschirm anzuzeigen.
- Im Backend sendet es das vollständige JSON an die von Ihnen konfigurierte Callback-URL. Die
Die operation_id ist die Brücke zwischen Frontend und Backend. Ohne sie können Sie nicht zuordnen, was im Browser geschehen ist, zu den Daten, die auf Ihrem Server ankommen.
Die Nachricht flow completed enthält keine Bankdaten. Die Daten gehen an den Callback. Wenn der Callback nicht mit HTTP 200 und {"status":"ok"} antwortet, erhält das Frontend kein flow completed.
Zuletzt aktualisiert