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 U as Utilisateur
participant W as Votre site web
participant WG as Wealth Reader Widget
participant API as Wealth Reader API
participant B as Institution financière
U->>W: Ouvre l’application
W->>WG: Insérez le iframe avec operation_id
U->>WG: Choisissez l’entité et donnez votre consentement
WG->>API: Demandez les données avec operation_id
API->>B: Demandez les détails du compte
B-->>API: Restitue les données brutes
API-->>WG: Restitue les données normalisées
WG->>W: Envoyez un POST au callback (operation_id + token + payload)
W-->>WG: Répondez HTTP 200 et status ok
WG-->>W: Envoie- postMessage flow completed
W-->>U: Affiche l’écran de réussite

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-24