IframeΒήμα 1 από 2

Ρύθμιση του frontend

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

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

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

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

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"`	Η ανάγνωση τελείωσε καλά και callback σας απάντησε `200` + `{"status":"ok"}`	Κλείστε το widget ή μεταβείτε στην οθόνη επιτυχίας. Τα τραπεζικά δεδομένα δεν ταξιδεύουν σε αυτό το μήνυμα.
JSON με `error`	Η ροή συνεχίζεται (2FA, συμβόλαιο κ.λπ.) ή έχει αποτύχει	Διαβάστε `error.code` και `error.message`. Η callback δεν έχει σταλεί.

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

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

Παράμετρος	Απαιτείται	Προεπιλογή	Τι κάνει
`operation_id`	Ναι	—	Ταυτότητα που δημιουργείτε. Πηγαίνετε πίσω στο callback για να περάσετε μπροστά και πίσω.
`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`	Όχι	—	Επανάληψη ελέγχου ταυτότητας: Προεπιλέξτε την τράπεζα ενός token που δεν είναι πλέον έγκυρο.
`psd2`	Όχι	`true`	Εμφανίζει οντότητες PSD2. Μόνο εάν δεν φιλτράρετε με `entities_to_display`.
`nonpsd2`	Όχι	`true`	Εμφανίζει οντότητες ανά κανάλι όχι PSD2 (πληρέστερες πληροφορίες). Ίδια απόχρωση με `psd2`.
`language`	Όχι	Το πρόγραμμα περιήγησης	`"es"` ή `"en"`.
`tokenize`	Όχι	αυτό στην περιοχή πελατών	`true` να αποκτήσετε ένα επαναχρησιμοποιήσιμο `token` στο callback.
`business_account`	Όχι	`true`	Περιλαμβάνει εταιρικές οντότητες.
`personal_account`	Όχι	`true`	Περιλαμβάνει οντότητες φυσικών προσώπων.

`wait_full_response`

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

`date_from`

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

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

`product_types`

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

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

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

Επόμενο βήμα

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

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

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

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

Μηνύματα postMessage

wr_conf Παράμετροι

wait_full_response

date_from

product_types