IframeΒήμα 1 από 2

Ρυθμίστε το frontend

Ενσωματώστε το γραφικό στοιχείο στη σελίδα σας, εμφανίστε τον επιλογέα τράπεζας και ακούστε τα μηνύματα του iframe.

Το widget είναι ένα iframe που φορτώνει με https://widget.wealthreader.com/js/load.js. Αυτή η σελίδα καλύπτει μόνο το μπροστινό μέρος. Τα δεδομένα επανάκλησης και τράπεζας έχουν οριστεί σε backend.

Ο τομέας από τον οποίο εξυπηρετείτε αυτήν τη σελίδα πρέπει να είναι εξουσιοδοτημένος στην περιοχή πελάτη πριν ανοίξετε το γραφικό στοιχείο. Εάν δεν είναι, το widget απαντά ότι ο τομέας δεν είναι εξουσιοδοτημένος.

Λίστα ελέγχου ενσωμάτωσης

0 από 3

Επιβεβαιώστε με το άτομο που έκανε την εγγραφή ότι έχετε λάβει το email καλωσορίσματος και ότι ο τομέας είναι ήδη εξουσιοδοτημένος.
Όπου πρέπει να εμφανίζεται ο επιλογέας οντότητας, εισαγάγετε τον παρακάτω κωδικό.
Ανοίξτε την εφαρμογή σας: Θα πρέπει να δείτε τον επιλογέα τράπεζας. Εάν δεν εμφανίζεται, ελέγξτε την κονσόλα του προγράμματος περιήγησής σας και επικοινωνήστε με την υποστήριξη.

Ελάχιστος κωδικός

Δημιουργήστε ένα operation_id νέο σε κάθε λειτουργία. Αφήστε entities_to_display κενό για να εμφανίσετε όλες τις οντότητες στο αρχείο . api_key Μείνετε wait_full_response true ασφαλείς από την τεχνική ομάδα που σας λέει το αντίθετο.

<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 Αναζητά το iframe με id="wr-iframe" και του εκχωρεί το ύψος ανάλογα με το παράθυρο. Τοποθετήστε το έτσι ώστε να έχει κατακόρυφο χώρο. Εάν το εισαγάγετε στη μέση της σελίδας, μπορεί να περικοπεί.

Μηνύματα `postMessage`

Το iframe μιλάει στη σελίδα σας ως εξής:

`event.data`	Πότε	Δραστηριότητες
`"flow completed"`	Η ανάγνωση τελείωσε `200` καλά και η επανάκληση σας απάντησε + `{"status":"ok"}`	Κλείστε το γραφικό στοιχείο ή μεταβείτε στην οθόνη επιτυχίας. Όχι τα τραπεζικά δεδομένα σε αυτό το μήνυμα.
JSON με `error`	Η ροή συνεχίζεται (2FA, συμβόλαιο κ.λπ.) ή έχει αποτύχει	Διαβάστε `error.code` και `error.message`. Η επανάκληση δεν έχει σταλεί.

Ελέγχετε πάντα event.origin === "https://widget.wealthreader.com".

Παράμετροι του `wr_conf`

Παράμετρος	Υποχρεωτικό	Προεπιλογή	Τι κάνει
`operation_id`	Ναι	—	Ταυτότητα που δημιουργείτε. Επιστρέψτε στην επανάκληση για να σταυρώσετε μπροστά και πίσω.
`entities_to_display`	Ναι	Όλα	Πίνακας κωδικών οντοτήτων. Κενό ή απόντα = όλα. Καταχώρηση: https://api.wealthreader.com/entities/
`wait_full_response`	Ναι	`true` `true`	: προϊόντα και συναλλαγές. `false`: μόνο ο κατάλογος των προϊόντων.
`date_from`	Ναι	χθες	Έναρξη συναλλαγών, `AAAA-MM-DD`. Ισχύει μόνο εάν `wait_full_response` είναι `true`.
`product_types`	Ναι	`api_key` δικός σας	Φίλτρο προϊόντος. Πίνακας ή λίστα διαχωρισμένη με κόμματα.
`default_login`	Ναι	—	Κωδικός οντότητας. Ανοίξτε απευθείας τη φόρμα αυτής της οντότητας.
`default_login_entity_country`	Ναι	`ES`	Κωδικός χώρας ISO (`ES`, `FR`, ...). Χρησιμοποιείται μόνο εάν υπάρχει `default_login`.
`token`	Ναι	—	Επανέλεγχος ταυτότητας: Προεπιλέγει την τράπεζα από ένα διακριτικό που δεν είναι πλέον έγκυρο.
`psd2`	Ναι	`true`	Εμφανίζει οντότητες PSD2. Μόνο αν δεν φιλτράρετε με `entities_to_display`.
`nonpsd2`	Ναι	`true`	Εμφανίζει οντότητες ανά κανάλι που δεν είναι PSD2 (πληρέστερες πληροφορίες). Ίδια απόχρωση με `psd2`το .
`language`	Ναι	Αυτό με το πρόγραμμα περιήγησης	`"es"` ή `"en"`.
`tokenize`	Ναι	αυτό στην περιοχή πελατών	`true` για να λάβετε μια `token` δυνατότητα επανάληψης στην επανάκληση.
`business_account`	Ναι	`true`	Περιλαμβάνει εταιρικές οντότητες.
`personal_account`	Ναι	`true`	Περιλαμβάνει οντότητες φυσικών προσώπων.

`wait_full_response`

Αφήστε το στο true. Η απενεργοποίησή του μειώνει την αναμονή (δευτερόλεπτα) με κόστος τη μη λήψη συναλλαγών. Μην το απενεργοποιήσετε εκτός εάν υπάρχει σαφής λόγος UX και, στη συνέχεια, ανακτήστε τις συναλλαγές αργότερα με το API και την token επανάκληση.

`date_from`

Εάν δεν το στείλετε, το widget χρησιμοποιεί χθεσινή ημερομηνία. Δεν είναι «όλη η ιστορία».

Για εύρη άνω των 89 ημερών στις ευρωπαϊκές τράπεζες, η οντότητα μπορεί να ζητήσει επιπλέον διπλό συντελεστή. Ο χρήστης το συμπληρώνει στο widget. Μπορεί να χρειαστούν αρκετά λεπτά για να διαβαστεί.

`product_types`

Πιθανές τιμές:

accounts — Λογαριασμοί
portfolios — Επενδυτικά χαρτοφυλάκια
cards — Κάρτες
receipts — αποδείξεις
loans — δάνεια
deposits — Καταθέσεις
leases — χρηματοδοτική μίσθωση / ενοικίαση
insurances — Ασφάλειες
factoring
confirming
properties — Ακίνητη περιουσία
invoices — τιμολόγια
files — αρχεία (άρθρα 43, 19, ...)

Παράδειγμα: ["accounts", "cards", "loans"] ή "accounts,cards,loans".

Επόμενο βήμα

Όταν ο επιλογέας φαίνεται καλός, συνεχίστε με το iframe backend.

Τελευταία ενημέρωση 2026-08-15

Λίστα ελέγχου ενσωμάτωσης

Ελάχιστος κωδικός

Μηνύματα postMessage

Παράμετροι του wr_conf

wait_full_response

date_from

product_types