Πρώτα βήματα

Ροή ολοκλήρωσης

Σωστή διαδρομή μιας ενσωμάτωσης iframe. Η callback αποστέλλεται πριν από την ειδοποίηση του frontend.

sequenceDiagram
participant U as Χρήστης
participant W as Ο ιστότοπός σας
participant WG as Wealth Reader Widget
participant API as API του Wealth Reader
participant B as Χρηματοπιστωτικό ίδρυμα
U->>W: Ανοίξτε την εφαρμογή
W->>WG: Τοποθετήστε το iframe με operation_id
U->>WG: Επιλέξτε την οντότητα και δώστε τη συγκατάθεσή σας
WG->>API: Ζητήστε τα δεδομένα με operation_id
API->>B: Ζητήστε στοιχεία λογαριασμού
B-->>API: Επιστρέφει ανεπεξέργαστα δεδομένα
API-->>WG: Επιστρέφει κανονικοποιημένα δεδομένα
WG->>W: Στείλτε ένα POST στο callback (operation_id + token + payload)
W-->>WG: Απάντηση HTTP 200 και status ok
WG-->>W: Αποστολή postMessage flow completed
W-->>U: Εμφανίζει την οθόνη επιτυχίας

Ποιος κάνει τι

Ηθοποιός	Ευθύνη
Το frontend σας	Δημιουργήστε μια μοναδική `operation_id` , φορτώστε το γραφικό στοιχείο και ακούστε `postMessage`.
Το widget	Εμφανίζει τράπεζες, σύνδεση, 2FA και σφάλματα στον χρήστη.
Η API του Wealth Reader	Μιλήστε με την οντότητα και ομαλοποιήστε την απόκριση.
Το backend σας	Εκθέτει τη διεύθυνση URL του callback, απαντά `{"status":"ok"}` και αποθηκεύει `operation_id`, `token` και payload.

Αν κάτι πάει στραβά

Λανθασμένος κωδικός πρόσβασης, 2FA ή σφάλμα οντότητας: το γραφικό στοιχείο επιλύει αυτό το πρόβλημα με τον χρήστη. Το μπροστινό μέρος σας μπορεί να λάβει μια JSON σφάλματος για postMessage. Το callback δεν καλείται μέχρι να ολοκληρωθεί καλά η ανάγνωση.
Το callback σας δεν ανταποκρίνεται 200 + {"status":"ok"}: ο χρήστης δεν βλέπει επιτυχία και το μπροστινό μέρος δεν λαμβάνει flow completed.
Ένα token δεν είναι πλέον έγκυρο (αλλαγή κωδικού πρόσβασης, νέο 2FA): ανοίξτε ξανά το γραφικό στοιχείο περνώντας αυτό το token για να επαναπιστοποιηθεί ο χρήστης.

Οι λεπτομέρειες κάθε μηνύματος και το σώμα του callback βρίσκονται στις σελίδες iframe.

Επόμενο βήμα

Εάν κάνετε ενσωμάτωση μέσω iframe, συνεχίστε κατά Frontend και μετά Παρασκήνιο. Εάν δεν μπορείτε να ενσωματώσετε ένα iframe, μεταβείτε στο OAuth.

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