Primeros pasos

Flujo de integración

Camino correcto de una integración por iframe. El callback se envía antes de avisar al frontend.

sequenceDiagram
participant U as Usuario
participant W as Tu web
participant WG as Widget de Wealth Reader
participant API as API de Wealth Reader
participant B as Entidad financiera
U->>W: Abre la aplicación
W->>WG: Inserta el iframe con operation_id
U->>WG: Elige la entidad y da su consentimiento
WG->>API: Solicita los datos con operation_id
API->>B: Pide los datos de las cuentas
B-->>API: Devuelve los datos en bruto
API-->>WG: Devuelve los datos normalizados
WG->>W: Envía un POST al callback (operation_id + token + payload)
W-->>WG: Responde HTTP 200 y status ok
WG-->>W: Envía postMessage flow completed
W-->>U: Muestra la pantalla de éxito

Quién hace qué

Actor	Responsabilidad
Tu frontend	Genera un `operation_id` único, carga el widget y escucha `postMessage`.
El widget	Muestra bancos, login, 2FA y errores al usuario.
La API de Wealth Reader	Habla con la entidad y normaliza la respuesta.
Tu backend	Expone la URL de callback, responde `{"status":"ok"}` y guarda `operation_id`, `token` y payload.

Si algo falla

Password incorrecto, 2FA o un error de la entidad: el widget lo resuelve con el usuario. Tu front puede recibir un JSON de error por postMessage; el callback no se llama hasta que la lectura termina bien.
Tu callback no responde 200 + {"status":"ok"}: el usuario no ve éxito y el front no recibe flow completed.
Un token deja de valer (cambio de contraseña, nuevo 2FA): vuelve a abrir el widget pasando ese token para que el usuario se reautentique.

El detalle de cada mensaje y del cuerpo del callback está en las páginas de iframe.

Siguiente paso

Si integras por iframe, sigue por frontend y después backend. Si no puedes embeber un iframe, ve a OAuth.

Última actualización 2026-08-24