Developers API & Widget
API Reference
GA

IframeCéim 1 de 2

Socraigh an ceann tosaigh

Leabú an ghiuirléid ar do leathanach, taispeáin an roghnóir bainc, agus éist le teachtaireachtaí an iframe.

Is iframe é an ghiuirléid a luchtaíonn le https://widget.wealthreader.com/js/load.js. Ní chlúdaíonn an leathanach seo ach an tosaigh. Tá na sonraí callback agus bainc socraithe go Inneall.

Ní mór an fearann óna bhfreastalaíonn tú ar an leathanach seo a bheith údaraithe i Réimse an chustaiméara sula n-osclaíonn tú an ghiuirléid. Mura bhfuil, freagraíonn an ghiuirléid nach bhfuil an fearann údaraithe.

Seicliosta comhtháthaithe

0 as 3

Cód íosta

Cruthaigh operation_id nua do gach oibríocht. Fág entities_to_display folamh chun na heintitis go léir i do api_keya thaispeáint. Coinnigh wait_full_response i true mura dtreoraíonn an fhoireann theicniúil a mhalairt.

<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 aimsíonn sé an iframe le id="wr-iframe" agus sannann sé an airde de réir na fuinneoige. Cuir é ionas go mbeidh spás ingearach aige; má chuireann tú isteach é i lár an leathanaigh, is féidir é a bhearradh.

Teachtaireachtaí postMessage

Labhraíonn an iframe le do leathanach mar seo:

event.data Cathain Cad atá le déanamh
"flow completed" Chríochnaigh an léamh go maith agus d'fhreagair do callback 200 + {"status":"ok"} Dún an ghiuirléid nó téigh go dtí an scáileán rathúlachta. Ní thaistealaíonn na sonraí bainc sa teachtaireacht seo.
JSON le error Leanann an sreabhadh (2FA, conradh, srl.) nó theip air Léigh error.code agus error.message. Níor seoladh an callback .

Seiceáil i gcónaí event.origin === "https://widget.wealthreader.com".

wr_conf Paraiméadair

Paraiméadar Riachtanach Réamhshocrú Cad a dhéanann sé
operation_id Is ea — Id a ghineann tú. Tagann sé ar ais sa callback chun an frontend agus an backend a nascadh.
entities_to_display Ní hea Gach rud Sraith de chóid eintiteas. Folamh nó as láthair = uile. Liosta: https://api.wealthreader.com/entities/
wait_full_response Ní hea true true- Táirgí agus idirbhearta. false- An liostú táirgí amháin.
date_from Ní hea inné Dáta tosaigh na n-idirbheart, AAAA-MM-DD. Ní bhaineann sé ach amháin má tá wait_full_response true.
product_types Ní hea iad siúd de do api_key Scagaire táirge. Eagar nó liosta scartha le camóga.
default_login Ní hea — Cód eintitis. Osclaíonn sé an fhoirm don eintiteas sin go díreach.
default_login_entity_country Ní hea ES Cód tíre ISO (ES, FR, ...). Ní úsáidtear é ach amháin má tá default_loginann.
token Ní hea — Athfhíordheimhniú: Réamhroghnaigh banc token nach bhfuil bailí a thuilleadh.
psd2 Ní hea true Taispeánann aonáin PSD2. Ach amháin mura ndéanann tú scagadh le entities_to_display.
nonpsd2 Ní hea true Taispeánann aonáin in aghaidh an chainéil nach bhfuil PSD2 (eolas níos iomláine). Nuance céanna le psd2.
language Ní hea An brabhsálaí "es" nó "en".
tokenize Ní hea an ceann i limistéar an chustaiméara true token in-athúsáidte a fháil sa callback.
business_account Ní hea true Áirítear le heintitis fiontraíochta.
personal_account Ní hea true Cuimsíonn sé eintitis daoine aonair.

wait_full_response

Fág ag trueé. Trí é a mhúchadh, giorraítear an fanacht (soicind) ar chostas gan idirbhearta a fháil. Ná díchumasaigh é mura bhfuil cúis shoiléir UX ann, agus ansin na hidirbhearta a aisghabháil níos déanaí le API agus token an callback.

date_from

Mura seolann tú é, úsáideann an ghiuirléid dáta an lae inné. Ní "an stair iomlán" é.

I gcás raonta níos mó ná 89 lá i mbainc na hEorpa, is féidir leis an eintiteas fachtóir dúbailte breise a iarraidh. Comhlánaíonn an t-úsáideoir é sa ghiuirléid; is féidir leis an léamh roinnt nóiméad a thógáil.

product_types

Luachanna féideartha:

  • accounts — Cuntais
  • portfolios — punanna infheistíochta
  • cards — cártaí
  • receipts — admhálacha
  • loans — iasachtaí
  • deposits — Taiscí
  • leases — léasú / ligean ar cíos
  • insurances — Árachas
  • factoring
  • confirming
  • properties — eastát réadach
  • invoices — sonraisc
  • files — comhaid (Riail 43, 19, ...)

Sampla: ["accounts", "cards", "loans"] nó "accounts,cards,loans".

An chéad chéim eile

Nuair a bhíonn cuma mhaith ar an roghnóir, lean le Inneall iframe.

Nuashonraithe