Erste Schritte

Integrationsfluss

Korrekter Pfad einer iframe-Integration. Der Rückruf wird vor dem Frontend benachrichtigt** gesendet.

sequenceDiagram
participant Usuario
participant Web
participant Widget as Wealth Reader Widget
participant API as Wealth Reader API
participant Banco as Entidad Financiera
Usuario->>Web: Abre la aplicación
Web->>Widget: Carga el iframe con operation_id
Usuario->>Widget: Elige entidad y da consentimiento
Widget->>API: Solicita los datos con operation_id
API->>Banco: Consulta
Banco-->>API: Responde
API-->>Widget: Devuelve datos normalizados
Widget->>Web: POST al callback (operation_id + token + payload)
Web-->>Widget: HTTP 200 y status ok
Widget-->>Web: postMessage flow completed
Web-->>Usuario: Muestra finalización OK

Wer macht was

Schauspieler	Verantwortung
Dein Frontend	Generiere eine `operation_id` Eins, lade das Widget und höre auf `postMessage`.
Das Widget	Es zeigt dem Nutzer Banken, Login, 2FA und Fehler an.
Die Wealth Reader API	Sprich mit der Entität und normalisiere die Antwort.
Dein Backend	Stellt die Callback-URL frei, antwortet `{"status":"ok"}` und speichertoperation_id``token sowie Payload.

Wenn etwas schiefgeht

Falsches Passwort, 2FA oder ein Entitätsfehler: Das Widget löst dies gemeinsam mit dem Benutzer. Ihr Front kann eine Fehler-JSON für postMessage; der Rückruf wird nicht aufgerufen, bis die Lesung erfolgreich abgeschlossen ist.
Ihr Rückruf antwortet 200 nicht + {"status":"ok"}: Der Nutzer sieht keinen Erfolg und die Front empfängt flow completednicht .
Eine Einstellung der gültigen Gültigkeit (Passwortänderung, neue 2FA): Öffnen token Sie das Widget erneut, indem Sie dieses token passieren, damit der Benutzer sich erneut authentifizieren kann.

Die Details jeder Nachricht und der Callback-Body sind auf den iframe-Seiten zu finden.

Nächster Schritt

Wenn du mit iframe integrierst, geh durch Frontend] und dann durch Backend. Wenn du keinen iframe einbetten kannst, gehe zu OAuth.

Zuletzt aktualisiert 2026-08-15