IframeÉtape 1 sur 2

Installe le frontend

Intégrez le widget sur votre page, affichez le sélecteur de banque, et écoutez les messages de l’iframe.

Le widget est un iframe qui charge avec https://widget.wealthreader.com/js/load.js. Cette page ne couvre que l’avant. Le rappel et les données bancaires sont réglés sur backend.

Le domaine depuis lequel vous servez cette page doit être autorisé dans la zone client avant d’ouvrir le widget. Si ce n’est pas le cas, le widget répond que le domaine n’est pas autorisé.

Checklist d'intégration

0 sur 3

Confirmez avec la personne qui s’est enregistrée que vous avez reçu l’email de bienvenue et que le domaine est déjà autorisé.
Là où le sélecteur d’entité devrait apparaître, insérez le code ci-dessous.
Ouvre ton application : tu devrais voir le sélecteur de banque. Si elle n’apparaît pas, vérifiez la console de votre navigateur et contactez le support.

Code minimum

Générez-en un operation_id nouveau à chaque opération. Laissez entities_to_display vide pour montrer toutes les entités dans votre api_keyfichier . Protégez-vous wait_full_response true du contraire par l’équipe technique.

<script>
    const wr_conf = {
        operation_id: crypto.randomUUID(),
        entities_to_display: [],
        wait_full_response: true
    };

    window.addEventListener("message", (event) => {
        if (event.origin !== "https://widget.wealthreader.com") {
            return;
        }

        if (event.data === "flow completed") {
            // El callback de backend ya se envió con éxito.
            // Cierra el selector o redirige a la pantalla de éxito.
            return;
        }

        if (typeof event.data !== "string") {
            return;
        }

        try {
            const message = JSON.parse(event.data);
            if (message.error) {
                console.log(message.error.code, message.error.message);
                // OTP, login incorrecto, callback caído, etc.
            }
        } catch (err) {
            // Ignora otros mensajes del iframe.
        }
    });
</script>

<iframe
    id="wr-iframe"
    title="Wealth Reader widget"
    width="100%"
    frameBorder="0"
    referrerpolicy="origin"
></iframe>
<script src="https://widget.wealthreader.com/js/load.js"></script>

load.js Il cherche l’iframe avec id="wr-iframe" et lui attribue la hauteur selon la fenêtre. Positionnez-le de façon à ce qu’il ait de l’espace vertical ; Si vous l’insérez au milieu de la page, il peut être recadré.

Messages `postMessage`

L’iframe s’adresse à votre page ainsi :

`event.data`	Quand	Choses à faire
`"flow completed"`	La lecture s’est bien terminée et ton rappel a `200` répondu + `{"status":"ok"}`	Fermez le widget ou allez à l’écran de réussite. Non les données bancaires dans ce message.
JSON avec `error`	Le flux continue (2FA, contract, etc.) ou a échoué	Lire `error.code` et `error.message`. Le rappel n’a pas été envoyé.

Vérifiez toujours event.origin === "https://widget.wealthreader.com".

Paramètres de `wr_conf`

Paramètre	Obligatoire	Par défaut	Ce que ça fait
`operation_id`	Oui	—	Id que vous générez. Revenir sur le rappel pour croiser avant et arrière.
`entities_to_display`	Oui	Tous	Tableau de codes d’entité. Vide ou absent = tous. Liste : https://api.wealthreader.com/entities/
`wait_full_response`	Oui	`true` `true`	: produits et transactions. `false`: seulement la liste des produits.
`date_from`	Oui	hier	Initiation des transactions, `AAAA-MM-DD`. Ne s’applique que si `wait_full_response` c’est `true`.
`product_types`	Oui	`api_key` À toi	Filtre à produits. Tableau ou liste séparée par virgules.
`default_login`	Oui	—	Code d’entité. Ouvrez directement la forme de cette entité.
`default_login_entity_country`	Oui	`ES`	Code pays ISO (`ES`, `FR`, ...). Utilisé uniquement s’il y a `default_login`.
`token`	Oui	—	Réauthentification : Pré-sélectionnez la banque à partir d’un jeton qui n’est plus valide.
`psd2`	Oui	`true`	Affiche les entités PSD2. Seulement si vous ne filtrez pas avec `entities_to_display`.
`nonpsd2`	Oui	`true`	Affiche les entités par canal non-PSD2 (informations plus complètes). Même nuance que `psd2`.
`language`	Oui	Celui avec le navigateur	`"es"` ou `"en"`.
`tokenize`	Oui	Celui de la zone client	`true` pour obtenir un `token` réutilisable dans le rappel.
`business_account`	Oui	`true`	Inclut les entités d’entreprise.
`personal_account`	Oui	`true`	Elle inclut des entités individuelles.

`wait_full_response`

Laisse-le à true. Le désactiver réduit l’attente (quelques secondes) au prix de ne pas recevoir de transactions. Ne le désactivez pas sauf s’il y a une raison UX claire, puis récupérez les transactions plus tard avec l’API et le token rappel.

`date_from`

Si vous ne l’envoyez pas, le widget utilise la date d’hier. Ce n’est pas « toute l’histoire ».

Pour des plages supérieures à 89 jours dans les banques européennes, l’entité peut demander un double facteur supplémentaire. L’utilisateur la complète dans le widget ; Cela peut prendre plusieurs minutes à lire.

`product_types`

Valeurs possibles :

accounts — Comptes
portfolios — Portefeuilles d’investissement
cards — Cartes
receipts — reçus
loans — prêts
deposits — Dépôts
leases — location / location
insurances — Assurance
factoring
confirming
properties — Immobilier
invoices — factures
files — dossiers (Règle 43, 19, ...)

Exemple : ["accounts", "cards", "loans"] ou "accounts,cards,loans".

Prochaine étape

Quand le sélecteur est bon, enchaînez avec iframe backend].

Dernière mise à jour 2026-08-15

Checklist d'intégration

Code minimum

Messages postMessage

Paramètres de wr_conf

wait_full_response

date_from

product_types