Πρώτα βήματα

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

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

sequenceDiagram
participant U as Χρήστης
participant W as Ο ιστότοπός σας
participant WG as Wealth Reader Widget
participant API as Wealth Reader API
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 επιστροφής κλήσης, τις `{"status":"ok"}` απαντήσεις και τις αποθηκεύσειςoperation_id``token και το ωφέλιμο φορτίο.

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

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

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

Επόμενο βήμα

Εάν ενσωματώνετε μέσω iframe, μεταβείτε στο frontend] και μετά στο backend. Εάν δεν μπορείτε να ενσωματώσετε ένα iframe, μεταβείτε στο OAuth.

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