Premiers pas

Flux d’intégration

Chemin correct d’une intégration iframe. Le rappel est envoyé avant d’avoir notifié le frontend.

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

Qui fait quoi

Acteur	Responsabilité
Votre Frontend	Générez un `operation_id` un, chargez le widget, et écoutez `postMessage`.
Le Widget	Il affiche les banques, la connexion, la 2FA et les erreurs à l’utilisateur.
L’API Wealth Reader	Parle à l’entité et normalise la réponse.
Votre backend	Affiche l’URL de `{"status":"ok"}` rappel, les réponses et les sauvegardes `operation_id`, `token` ainsi que la charge utile.

Si quelque chose tourne mal

Mot de passe incorrect, 2FA, ou erreur d’entité : le widget résout cela avec l’utilisateur. Votre front peut recevoir une erreur JSON pour postMessage; le rappel n’est pas appelé tant que la lecture n’est pas terminée avec succès.
Votre rappel ne répond 200 pas + {"status":"ok"}: l’utilisateur ne voit pas de succès et le front ne reçoit flow completedpas .
Un token cess d’être valide (changement de mot de passe, nouvelle 2FA) : rouvrir le widget en passant celui-ci token afin que l’utilisateur puisse se réauthentifier.

Le détail de chaque message et le corps du rappel se trouvent sur les pages iframe.

Prochaine étape

Si vous intégrez par iframe, passez par frontend ] puis backend. Si vous ne pouvez pas intégrer un iframe, allez sur OAuth.

Dernière mise à jour 2026-08-15