IframeΒήμα 2 από 2

Ρυθμίστε το backend

Λάβετε τα κανονικοποιημένα τραπεζικά στοιχεία στον διακομιστή σας και επιβεβαιώστε σωστά την επανάκληση.

Συμπληρώστε πρώτα τη λίστα ελέγχου διεπαφής]. Το widget δεν στέλνει τραπεζικά στοιχεία από postMessage: τα στέλνει εδώ, χρησιμοποιώντας POST.

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

0 από 4

Δημιουργήστε τη διεύθυνση URL επανάκλησης
Συσχέτιση τομέα, επανάκληση και api_key
Δοκιμή της ροής με έναν δοκιμαστικό χρήστη
Αποθήκευση operation_id``token και statistics.code

1. Δημιουργία της διεύθυνσης URL επιστροφής κλήσης

Εκθέστε ένα τελικό σημείο HTTPS στον διακομιστή σας που δέχεται με POST σώμα JSON.

Μετά την επεξεργασία όπως απαιτείται, αποκρίνεται στο HTTP 200 με το ακόλουθο JSON:

{
    "status": "ok"
}

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

Αντιμετωπίστε operation_id ως ανίκανο: Η επαναλαμβανόμενη παράδοση δεν θα πρέπει να δημιουργεί δύο λειτουργίες στο σύστημά σας.

2. Τι έρχεται στο POST

Το σώμα είναι το ίδιο JSON όπως POST /entities/ στην αναφορά OpenAPI. Τα σημαντικά πράγματα για να διασχίσετε τη λειτουργία:

Πεδίο	Εφαρμογή
`success` `true`	αν η ανάγνωση τελείωνε καλά.
`payload`	Τυποποιημένα δεδομένα (λογαριασμοί, πορτοφόλια, κάρτες κ.λπ.).
`statistics.operation_id`	Αυτό `operation_id` που δημιούργησε το frontend σας.
`statistics.token`	Διαπιστευτήρια θεματοφυλακής για επόμενα αναψυκτικά (εάν το tokenization είναι ενεργό).
`statistics.code`	Κωδικός οντότητας (`bbva`, `caixabank`, ...).
`statistics.SESSION`	Αναγνωριστικό συνεδρίας, χρήσιμο σε ένα δελτίο υποστήριξης.
`statistics.warnings`	Προειδοποιήσεις που δεν ακυρώνουν την ένδειξη (για παράδειγμα, ένα άδειο προϊόν).

Παράδειγμα αποκοπής:

{
    "success": true,
    "payload": {
        "user_information": {
            "ID": "12345678Z",
            "name": "LUIS GARCIA BAQUERO"
        },
        "accounts": [
            {
                "uuid": "8076932f04f73e27fe608fee4d12fca8708dec8c",
                "subtype": "checking",
                "code": "ES4914651234561234567890",
                "name": "Cuenta NOMINA",
                "currency": "EUR",
                "balances": {
                    "available": 14302.07,
                    "current": 14302.07
                },
                "transactions": []
            }
        ]
    },
    "statistics": {
        "SESSION": "A1B2C3D4E5F67890",
        "execution_time": 12.4,
        "warnings": [],
        "operation_id": "8f1c2a6e-4b0d-4c3a-9e21-0d5b7a91c4e2",
        "token": "FRJ0mHlaqZwLzu",
        "code": "bbva"
    }
}

Το πλήρες σχήμα βρίσκεται payload στο OpenAPI. Μην υποθέτετε ότι όλα τα κλειδιά εισέρχονται πάντα: εξαρτώνται από product_types το τι έχει ο χρήστης στην οντότητα.

3. Συσχέτιση τομέα, επανάκλησης και κλειδιού API

Στην περιοχή πελατών] συνεργάτης:

τον τομέα από τον οποίο φορτώνεται το widget (η προέλευση της πρόσοψης σας).
τη διεύθυνση URL επανάκλησης που μόλις δημιουργήσατε.
εσύapi_key.

Μέχρι να καταχωρηθεί ο τομέας, το widget δεν λειτουργεί.

4. Δοκιμάστε τη ροή

Ανοίξτε τη σελίδα που φορτώνει το γραφικό στοιχείο και συνδεθείτε:

Χρήστης	Κωδικός πρόσβασης	Αποτέλεσμα
`MOCKDATA`	Όλα	Σωστή ανάγνωση με ανώνυμα παραδείγματα δεδομένων. Η επανάκληση λαμβάνει ένα JSON.`success: true`
`MOCKOTP`	Όλα	Αναδημιουργείτε μια πρόκληση δύο παραγόντων.
`MOCKLOGINKO`	Όλα	Δημιουργείτε ξανά ένα σφάλμα σύνδεσης. Η επανάκληση δεν καλείται.

Εάν δεν έχετε το email καλωσορίσματος, ζητήστε το στο support@wealthreader.com.

Εάν θέλετε να δείτε το POST πριν έχετε το τελικό σημείο στο περιβάλλον σας, δημιουργήστε μια προσωρινή διεύθυνση URL σε μια υπηρεσία όπως https://pipedream.com/ και τοποθετήστε την ως επανάκληση.

5. Ανανέωση δεδομένων (προαιρετικό)

Μέχρι στιγμής έχετε μια ενσωμάτωση one shot: μία ανάγνωση για κάθε φορά που ο χρήστης ανοίγει το widget.

Εάν χρειάζεστε μια ολονύκτια παρτίδα ή ένα κουμπί "ενημέρωσης", καλέστε ξανά το API με αυτό token και αυτό code που αποθηκεύσατε από την επανάκληση. Μην ζητάτε νέο όνομα χρήστη και κωδικό πρόσβασης.

curl --location 'https://api.wealthreader.com/entities/' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'api_key=TU_API_KEY' \
  --data-urlencode 'code=bbva' \
  --data-urlencode 'token=EL_TOKEN_DEL_CALLBACK' \
  --data-urlencode 'product_types=accounts,portfolios'

Δώστε προσοχή στους κωδικούς σφάλματος](https://api.wealthreader.com/error-codes/): ένας μη έγκυρος κωδικός πρόσβασης δεν επιχειρείται ξανά, μια συντήρηση οντότητας δοκιμάζεται.

Προδιαγραφές OpenAPI v3
Συλλογή Ταχυδρόμου

Εάν η αλλαγή κωδικού πρόσβασης ή ο token νέος 2FA δεν είναι έγκυρος, ανοίξτε ξανά το widget μεταβιβάζοντας αυτήν την τιμή wr_conf.token για να γίνει εκ νέου έλεγχος ταυτότητας από τον χρήστη. /support@wealthreader.com

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