IframeStap 1 van 2

Zet de frontend op

Embed de widget op je pagina, toon de bankkiezer en luister naar de berichten van het iframe.

De widget is een iframe dat met https://widget.wealthreader.com/js/load.jslaadt. Deze pagina behandelt alleen de voorkant. De callback - en bankgegevens zijn ingesteld op Backend.

Het domein van waaruit u deze pagina bedient, moet geautoriseerd zijn in Het klantengebied voordat je de widget opent. Als dat niet zo is, reageert de widget dat het domein niet geautoriseerd is.

Integratiechecklist

0 van 3

Bevestig bij de persoon die de registratie heeft uitgevoerd dat je de welkomstmail hebt ontvangen en dat het domein al is geautoriseerd.
Waar de entiteitsselector zou moeten verschijnen, vul de code hieronder in.
Open je app: Je zou de bankselector moeten zien. Als die niet verschijnt, controleer dan je browserconsole en Contact Support.

Minimumcode

Genereer een nieuw operation_id voor elke bewerking. Laat entities_to_display leeg om alle entiteiten in je api_keyte tonen. Houd wait_full_response in true tenzij het technische team anders instructeert.

<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 vindt het iframe met id="wr-iframe" en wijst het de hoogte toe volgens het venster. Plaats het zo dat het verticale ruimte heeft; als je het in het midden van de pagina invoegt, kan het worden bijgesneden.

Berichten `postMessage`

Het iframe spreekt zo met je pagina:

`event.data`	Wanneer	Wat te doen
`"flow completed"`	De lezing eindigde goed en je callback antwoordde `200` + `{"status":"ok"}`	Sluit de widget of ga naar het successcherm. De bankgegevens worden niet verzonden in dit bericht.
JSON met `error`	De stroom gaat door (2FA, contract, enz.) of is mislukt	Lees `error.code` en `error.message`. De callback is niet verzonden.

Controleer altijd event.origin === "https://widget.wealthreader.com".

`wr_conf` Parameters

Parameter	Verplicht	Standaard	Wat het doet
`operation_id`	Ja	—	Identificatie die je zelf genereert. Deze komt terug in de callback om frontend en backend aan dezelfde operatie te koppelen.
`entities_to_display`	Nee	Allemaal	Array van entiteitscodes. Leeg of afwezig = alle. Lijst: https://api.wealthreader.com/entities/
`wait_full_response`	Nee	`true`	`true`- Producten en transacties. `false`- Alleen de productlijst.
`date_from`	Nee	Gisteren	Begindatum van de op te vragen transacties, `AAAA-MM-DD`. Alleen van toepassing als `wait_full_response` `true`.
`product_types`	Nee	die van uw `api_key`	Productfilter. Array of komma-gescheiden lijst.
`default_login`	Nee	—	Entiteitscode. Opent het formulier voor die entiteit direct.
`default_login_entity_country`	Nee	`ES`	ISO-landcode (`ES`, `FR`, ...). Alleen gebruikt als er `default_login`is.
`token`	Nee	—	Herauthenticatie: Selecteer vooraf de bank van een token die niet langer geldig is.
`psd2`	Nee	`true`	Toont entiteiten PSD2. Alleen als je niet filtert met `entities_to_display`.
`nonpsd2`	Nee	`true`	Toont entiteiten per kanaal, niet PSD2 (meer volledige informatie). Dezelfde nuance als `psd2`.
`language`	Nee	De browser	`"es"` of `"en"`.
`tokenize`	Nee	die in het klantengebied	`true` om een herbruikbare `token` in de callbackte krijgen.
`business_account`	Nee	`true`	Inclusief zakelijke entiteiten.
`personal_account`	Nee	`true`	Het omvat entiteiten van individuen.

`wait_full_response`

Laat het op true. Het uitschakelen verkort de wachttijd (seconden), maar dan krijg je geen transacties meer. Schakel het niet uit tenzij er een duidelijke UX-reden is, en haal de transacties later terug met de API en token van de callback.

`date_from`

Als je het niet verstuurt, gebruikt de widget de datum van gisteren. Het is niet "de hele geschiedenis."

Voor intervallen van meer dan 89 dagen bij Europese banken kan de entiteit om een extra dubbele factor vragen. De gebruiker vult deze in de widget; de lezing kan enkele minuten duren.

`product_types`

Mogelijke waarden:

accounts — Rekeningen
portfolios — beleggingsportefeuilles
cards — kaarten
receipts — incasso’s
loans — leningen
deposits — deposito’s
leases — lease / huren
insurances — Verzekering
factoring
confirming
properties — vastgoed
invoices — facturen
files — bestanden (Norma 43, 19, …)

Voorbeeld: ["accounts", "cards", "loans"] of "accounts,cards,loans".

Volgende stap

Als de selector er goed uitziet, volg dan met iframe-backend.

Laatst bijgewerkt 2026-09-10

Integratiechecklist

Minimumcode

Berichten postMessage

wr_conf Parameters

wait_full_response

date_from

product_types