IframeTrin 1 af 2

Sæt frontend op

Indlejr widgetten på din side, vis bankvælgeren, og lyt til iframens beskeder.

Widgetten er en iframe, der loader med https://widget.wealthreader.com/js/load.js. Denne side dækker kun forsiden. Callback- og bankdata er sat til backend.

Domænet, hvorfra du serverer denne side, skal være autoriseret i klientområdet før widgetten åbnes. Hvis det ikke er, svarer widgetten, at domænet ikke er autoriseret.

Integrationstjekliste

0 af 3

Bekræft med den person, der har registreret dig, at du har modtaget velkomstmailen, og at domænet allerede er godkendt.
Hvor entitetsvælgeren skal vises, indsæt koden nedenfor.
Åbn din app: du burde se bankvælgeren. Hvis det ikke dukker op, så tjek din browserkonsol og kontakt support.

Minimumskode

Generer en operation_id ny i hver operation. Lad entities_to_display det stå tomt for at vise alle entiteterne i din api_key. Pas wait_full_response true på dig selv, så det tekniske team ikke siger noget andet.

<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 Den leder efter iframe med id="wr-iframe" og tildeler den højden i henhold til vinduet. Placer den, så den har lodret plads; Hvis du indsætter det midt på siden, kan det beskæres.

Beskeder `postMessage`

iframen taler til din side sådan her:

`event.data`	Når	Ting at lave
`"flow completed"`	Læsningen sluttede godt og din tilbagekaldelse svarede `200` + `{"status":"ok"}`	Luk widgetten eller gå til successkærmen. Nej bankoplysningerne i denne besked.
JSON med `error`	Flowet fortsætter (2FA, kontrakt osv.) eller er fejlet	Læs `error.code` og `error.message`. Tilbagekaldelsen er ikke sendt.

Tjek altid event.origin === "https://widget.wealthreader.com".

Parametre for `wr_conf`

Parameter	Påkrævet	Standard	Hvad den gør
`operation_id`	Ja	—	Var det, du genererer. Vend tilbage på callback-opkaldet for at krydse front og back.
`entities_to_display`	Ja	Alle	Array af entitetskoder. Tomt eller fraværende = alle. Liste: https://api.wealthreader.com/entities/
`wait_full_response`	Ja	`true` `true`	: produkter og transaktioner. `false`: kun listen over produkter.
`date_from`	Ja	i går	Igangsættelse af transaktioner, `AAAA-MM-DD`. Gælder kun, hvis `wait_full_response` den er `true`.
`product_types`	Ja	`api_key` Din	Produktfilter. Array eller komma-separeret liste.
`default_login`	Ja	—	Entitetskode. Åbn formen for den enhed direkte.
`default_login_entity_country`	Ja	`ES`	ISO-landekode (`ES`, `FR`, ...). Bruges kun, hvis der er `default_login`.
`token`	Ja	—	Genautentificering: Forvælger banken fra en token, der ikke længere er gyldig.
`psd2`	Ja	`true`	Viser PSD2-enheder. Kun hvis du ikke filtrerer med `entities_to_display`.
`nonpsd2`	Ja	`true`	Viser enheder pr. ikke-PSD2 kanal (mere komplet information). Samme nuance som `psd2`.
`language`	Ja	Den med browseren	`"es"` eller `"en"`.
`tokenize`	Ja	den i kundeområdet	`true` for at få en `token` genanvendelig i callbacken.
`business_account`	Ja	`true`	Omfatter virksomhedsenheder.
`personal_account`	Ja	`true`	Det omfatter individers enheder.

`wait_full_response`

Lad det være ved true. At slukke den forkorter ventetiden (sekunder) på bekostning af ikke at modtage transaktioner. Deaktiver det ikke, medmindre der er en klar UX-grund, og hent transaktionerne senere med API'et og callbacken token .

`date_from`

Hvis du ikke sender den, bruger widgetten gårsdagens dato. Det er ikke "hele historien."

For intervaller på mere end 89 dage i europæiske banker kan enheden kræve en ekstra dobbelt faktor. Brugeren udfylder det i widgetten; Det kan tage flere minutter at læse.

`product_types`

Mulige værdier:

accounts — Regnskaber
portfolios — Investeringsporteføljer
cards — Kort
receipts — kvitteringer
loans — lån
deposits — Forekomster
leases — leasing / udlejning
insurances — Forsikring
factoring
confirming
properties — Ejendomme
invoices — fakturaer
files — filer (Regel 43, 19, ...)

Eksempel: ["accounts", "cards", "loans"] eller "accounts,cards,loans".

Næste skridt

Når selectoren ser god ud, følg op med iframe backend.

Senest opdateret 2026-08-15

Integrationstjekliste

Minimumskode

Beskeder postMessage

Parametre for wr_conf

wait_full_response

date_from

product_types