Developers API & Widget
API Reference
FR

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)

  1. Votre page charge le widget avec un operation_id que vous générez.
  2. L’utilisateur choisit l’établissement, donne son consentement et termine l’authentification à deux facteurs si nécessaire. Le widget gère ces étapes.
  3. 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_id figure 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.

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