Πρώτα βήματα

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

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

sequenceDiagram
participant Usuario
participant Web
participant Widget as Wealth Reader Widget
participant API as Wealth Reader API
participant Banco as Entidad Financiera
Usuario->>Web: Abre la aplicación
Web->>Widget: Carga el iframe con operation_id
Usuario->>Widget: Elige entidad y da consentimiento
Widget->>API: Solicita los datos con operation_id
API->>Banco: Consulta
Banco-->>API: Responde
API-->>Widget: Devuelve datos normalizados
Widget->>Web: POST al callback (operation_id + token + payload)
Web-->>Widget: HTTP 200 y status ok
Widget-->>Web: postMessage flow completed
Web-->>Usuario: Muestra finalización OK

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

Ηθοποιός	Υπευθυνότητα
Το 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-15