IframeTrin 1 af 2

Opsætning af frontend

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

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

Det domæne, du serverer denne side fra, skal være autoriseret i Kundeområdet før du åbner widgetten. Hvis den ikke er, svarer widgetten, at domænet ikke er autoriseret.

Integrationstjekliste

0 af 3

Bekræft med kontoregistratoren, 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 den ikke vises, tjek din browserkonsol og Kontakt Support.

Minimumskode

Generer en ny operation_id for hver operation. Lad entities_to_display stå tom, så alle entiteter i din api_keyvises. Hold wait_full_response i true , medmindre det tekniske team instruerer 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 finder iframen med id="wr-iframe" og tildeler den højden i henhold til vinduet. Placer den, så den har lodret plads; hvis du indsætter den midt på siden, kan den beskæres.

Beskeder `postMessage`

iframen taler til din side sådan her:

`event.data`	Hvornår	Hvad skal man gøre
`"flow completed"`	Læsningen sluttede godt , og din callback svarede `200` + `{"status":"ok"}`	Luk widgetten eller gå til successkærmen. Bankdataene sendes ikke i denne besked.
JSON med `error`	Flowet fortsætter (2FA, kontrakt osv.) eller er fejlet	Læs `error.code` og `error.message`. callback er ikke blevet sendt.

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

`wr_conf` Parametre

Parameter	Påkrævet	Default	Hvad den gør
`operation_id`	Ja	—	Identifikator, som du genererer, og som returneres i callback for at forbinde frontend og backend.
`entities_to_display`	Nej	Alle	Array af entitetskoder. Tomt eller fraværende = alle. Liste: https://api.wealthreader.com/entities/
`wait_full_response`	Nej	`true`	`true`- Produkter og transaktioner. `false`- Kun produktoversigten.
`date_from`	Nej	I går	Startdato for transaktioner, `AAAA-MM-DD`. Gælder kun, hvis `wait_full_response` er `true`.
`product_types`	Nej	dem af dine `api_key`	Produktfilter. Array eller komma-separeret liste.
`default_login`	Nej	—	Entitetskode. Åbner formularen for den enhed direkte.
`default_login_entity_country`	Nej	`ES`	ISO-landekode (`ES`, `FR`, ...). Bruges kun, hvis der er `default_login`.
`token`	Nej	—	Genautentificering: Forudvælg banken for en token , der ikke længere er gyldig.
`psd2`	Nej	`true`	Viser entiteter PSD2. Kun hvis du ikke filtrerer med `entities_to_display`.
`nonpsd2`	Nej	`true`	Viser enheder pr. kanal, ikke PSD2 (mere komplet information). Samme nuance som `psd2`.
`language`	Nej	Browseren	`"es"` eller `"en"`.
`tokenize`	Nej	Den i kundeområdet	`true` at få en genanvendelig `token` i callback.
`business_account`	Nej	`true`	Omfatter virksomhedsenheder.
`personal_account`	Nej	`true`	Det omfatter individers enheder.

`wait_full_response`

Lad det stå på true. At slukke for det forkorter ventetiden (sekunder) på bekostning af ikke at modtage transaktioner. Deaktiver det ikke, medmindre der er en klar UX-årsag, og genopret transaktionerne senere med API og token af callback.

`date_from`

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

For intervaller på mere end 89 dage i europæiske banker kan enheden bede om en ekstra dobbelt faktor. Brugeren udfylder det i widgetten; aflæsningen kan tage flere minutter.

`product_types`

Mulige værdier:

accounts — konti
portfolios — investeringsporteføljer
cards — kort
receipts — kvitteringer
loans — lån
deposits — indlån
leases — leasing / udlejning
insurances — Forsikring
factoring
confirming
properties — fast ejendom
invoices — fakturaer
files — filer (Regel 43, 19, ...)

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

Næste skridt

Når vælgeren ser god ud, følg op med iframe-backend.

Senest opdateret 2026-09-10

Integrationstjekliste

Minimumskode

Beskeder postMessage

wr_conf Parametre

wait_full_response

date_from

product_types