IframeTrinn 1 av 2

Sett opp frontenden

Legg inn widgeten på siden din, vis bankvelgeren, og lytt til iframe-meldingene.

Widgeten er en iframe som laster med https://widget.wealthreader.com/js/load.js. Denne siden dekker kun fronten. callback og bankdata er satt til Backend.

Domenet du serverer denne siden fra, må være autorisert i Kundeområdet før du åpner widgeten. Hvis den ikke er det, svarer widgeten at domenet ikke er autorisert.

Integrasjonssjekkliste

0 av 3

Bekreft med kontoregistraren at du har mottatt velkomstmailen og at domenet allerede er autorisert.
Der entitetsvelgeren skal vises, sett inn koden nedenfor.
Åpne appen din: Du skal se bankvelgeren. Hvis den ikke vises, sjekk nettleserkonsollen din og Kontakt Support.

Minimumskode

Generer en ny operation_id for hver operasjon. La entities_to_display stå tomt for å vise alle entitetene i din api_key. Hold wait_full_response i true med mindre teknisk team angir andre instruksjoner.

<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 finner iframen med id="wr-iframe" og tildeler den høyden i henhold til vinduet. Plasser den slik at den har vertikal plass; hvis du setter den inn midt på siden, kan den beskjæres.

Meldinger `postMessage`

iframen snakker til siden din slik:

`event.data`	Når	Hva skal man gjøre
`"flow completed"`	Opplesningen endte bra , og callback svarte `200` + `{"status":"ok"}`	Lukk widgeten eller gå til suksessskjermen. Bankdataene sendes ikke i denne meldingen.
JSON med `error`	Flyten fortsetter (2FA, kontrakt osv.) eller har feilet	Les `error.code` og `error.message`. callback er ikke sendt.

Sjekk alltid event.origin === "https://widget.wealthreader.com".

`wr_conf` Parametere

Parameter	Påkrevd	Default	Hva det gjør
`operation_id`	Ja	—	Identifikator som du genererer. Returneres i callback for å koble frontend og backend.
`entities_to_display`	Nei	Alle	Array av entitetskoder. Tomt eller fraværende = alle. Liste: https://api.wealthreader.com/entities/
`wait_full_response`	Nei	`true`	`true`- Produkter og transaksjoner. `false`- Kun produktlisten.
`date_from`	Nei	I går	Startdato for transaksjonene som skal hentes, `AAAA-MM-DD`. Gjelder kun hvis `wait_full_response` er `true`.
`product_types`	Nei	de av dine `api_key`	Produktfilter. Array eller komma-separert liste.
`default_login`	Nei	—	Entitetskode. Åpner skjemaet for den enheten direkte.
`default_login_entity_country`	Nei	`ES`	ISO landkode (`ES`, `FR`, ...). Brukes kun hvis det finnes `default_login`.
`token`	Nei	—	Reautentisering: Forhåndsvelg banken til en token som ikke lenger er gyldig.
`psd2`	Nei	`true`	Viser entiteter PSD2. Bare hvis du ikke filtrerer med `entities_to_display`.
`nonpsd2`	Nei	`true`	Viser enheter per kanal, ikke PSD2 (mer fullstendig informasjon). Samme nyanse som `psd2`.
`language`	Nei	Nettleseren	`"es"` eller `"en"`.
`tokenize`	Nei	den i kundeområdet	`true` for å få en gjenbrukbar `token` i callback.
`business_account`	Nei	`true`	Inkluderer bedriftsenheter.
`personal_account`	Nei	`true`	Det inkluderer individers enheter.

`wait_full_response`

La den stå på true. Å slå den av forkorter ventetiden (sekunder) på bekostning av at du ikke mottar transaksjoner. Ikke deaktiver den med mindre det er en klar UX-grunn, og hent deretter transaksjonene senere med API og token av callback.

`date_from`

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

For intervaller på mer enn 89 dager i europeiske banker kan enheten be om en ekstra dobbel faktor. Brukeren fullfører dette i widgeten; avlesningen kan ta flere minutter.

`product_types`

Mulige verdier:

accounts — kontoer
portfolios — investeringsporteføljer
cards — kort
receipts — kvitteringer
loans — lån
deposits — innskudd
leases — leasing / utleie
insurances — Forsikring
factoring
confirming
properties — eiendom
invoices — fakturaer
files — filer (Regel 43, 19, ...)

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

Neste steg

Når velgeren ser bra ut, følg opp med iframe-backend.

Sist oppdatert 2026-09-10

Integrasjonssjekkliste

Minimumskode

Meldinger postMessage

wr_conf Parametere

wait_full_response

date_from

product_types