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 :
- D’une inscription terminée et d’une
api_key. - D’une session d’onboarding avec l’équipe technique. Réservez la vôtre depuis Support.
- De choisir le type d’intégration (ci-dessous).
- D’une URL HTTPS qui reçoit le callback, si vous intégrez via iframe.
Choisissez le type d’intégration
| Critère | Iframe (widget) | OAuth |
|---|---|---|
| Quand | Application web pouvant intégrer un iframe | Application native, ou vous ne pouvez pas intégrer d’iframe |
| Frontend | Vous insérez le widget dans votre page | Vous redirigez l’utilisateur vers oauth.wealthreader.com |
| Données | Arrivent en POST sur votre URL de callback |
Vous les obtenez en menant à bien le challenge sur /token/ |
| Commencez par | Iframe : frontend | OAuth : backend |
La plupart des clients web utilisent l’iframe.
Fonctionnement (iframe)
- Votre page charge le widget avec un
operation_idque vous générez. - L’utilisateur choisit l’établissement, donne son consentement et termine l’authentification à deux facteurs si nécessaire. Le widget gère ces étapes.
- Wealth Reader récupère les données et fait deux choses, dans cet ordre :
- Côté backend, il envoie le JSON complet à l’URL de callback que vous avez configurée. L’
operation_idfigure dans cette réponse afin que vous puissiez la relier à l’opération du frontend. - Côté frontend, l’iframe notifie votre page avec
postMessage(flow completed) uniquement si le callback a réussi. Utilisez ce signal pour fermer le sélecteur ou afficher un écran de succès.
- Côté backend, il envoie le JSON complet à l’URL de callback que vous avez configurée. L’
L’operation_id est le pont entre le frontend et le backend. Sans lui, vous ne pouvez pas faire correspondre ce qui s’est passé dans le navigateur avec les données qui arrivent sur votre serveur.
Le message flow completed ne contient pas les données bancaires. Les données vont au callback. Si le callback ne répond pas HTTP 200 avec {"status":"ok"}, le frontend ne reçoit pas flow completed.
Dernière mise à jour