Premiers pas
Introduction
Ce guide explique comment intégrer Wealth Reader : l’utilisateur choisit sa banque, s’authentifie, et votre système reçoit les données normalisées.
Exemple du résultat final : https://widget.wealthreader.com/demo-all/
Avant de commencer
Vous avez besoin de :
- Avoir finalisé votre inscription et disposer d’une
api_key. - Une séance d’intégration avec l’équipe technique. Réservez la vôtre sur Soutien.
- Décidez du type d’intégration (ci-dessous).
- Une URL HTTPS pour recevoir le rappel, si vous intégrez par iframe.
Choisissez le type d’intégration
| Critères | Iframe (widget) | OAuth |
|---|---|---|
| Quand | Application web pouvant intégrer un iframe | Application native, sinon vous ne pouvez pas intégrer un iframe |
| Frontend | Vous intégrez le widget sur votre page | Vous redirigez l’utilisateur vers oauth.wealthreader.com |
| Données | Ils arrivent par POST à votre URL de rappel |
Vous les obtenez en terminant le défi dans /token/ |
| Commencez par | Iframe : frontend | OAuth: backend |
La plupart des clients web utilisent iframe.
Programmez-vous avec un assistant IA ? Installez le compétence Wealth Reader dans Claude Code, Codex, Cursor, Copilot ou Gemini CLI et construisez l’intégration en suivant ce guide.
Comment ça fonctionne (iframe)
- Votre page charge le widget avec un
operation_idque vous générez. - L’utilisateur choisit l’entité, donne son consentement, et résout le système à deux facteurs si nécessaire. Le widget gère ces étapes.
- Wealth Reader obtient les données et fait deux choses, Dans cet ordre:
- Dans le Backend, envoie le JSON complet à l’URL de rappel que vous avez configurée. Le
operation_idse déplace dans cette réponse afin que vous puissiez l’associer à votre opération front-end. - Dans le Frontend, l’iframe alerte votre page avec
postMessage(flow completed) uniquement si le rappel a bien répondu. Utilisez-le pour fermer le sélecteur ou afficher un écran de réussite.
- Dans le Backend, envoie le JSON complet à l’URL de rappel que vous avez configurée. Le
Le operation_id relie le frontend et le backend. Sans cela, vous ne pouvez pas croiser ce qui s’est passé dans le navigateur avec les données arrivant sur votre serveur.
Le message flow completed ne contient pas les données de la banque. Les données se dirigent vers le rappel. Si le rappel ne répond pas HTTP 200 avec {"status":"ok"}, le frontend ne reçoit pas flow completed.