Πρώτα βήματα
Εισαγωγή
Αυτός ο οδηγός εξηγεί πώς να ενσωματώσετε Wealth Reader: ο χρήστης επιλέγει την τράπεζά του, πραγματοποιεί έλεγχο ταυτότητας και το σύστημά σας λαμβάνει τα κανονικοποιημένα δεδομένα.
Παράδειγμα του τελικού αποτελέσματος: https://widget.wealthreader.com/demo-all/
Πριν ξεκινήσετε
Χρειάζεστε:
- Να έχετε ολοκληρώσει την εγγραφή λογαριασμού και να έχετε
api_key. - Μια συνεδρία ενσωμάτωσης με την τεχνική ομάδα. Κάντε κράτηση από Υποστήριξη.
- Αποφασίστε για το είδος της ενσωμάτωσης (παρακάτω).
- Μια διεύθυνση URL HTTPS λάβει το callback, εάν κάνετε ενσωμάτωση μέσω iframe.
Επιλέξτε τον τύπο ενσωμάτωσης
| Κριτήρια | Iframe (γραφικό στοιχείο) | OAuth |
|---|---|---|
| Πότε | Διαδικτυακή εφαρμογή που μπορεί να ενσωματώσει ένα iframe | Εγγενής εφαρμογή ή δεν μπορείτε να ενσωματώσετε ένα iframe |
| Μπροστινό μέρος | Ενσωματώνετε το widget στη σελίδα σας | Ανακατευθύνετε τον χρήστη στο oauth.wealthreader.com |
| Δεδομένα | Φτάνουν POST στη διεύθυνση URL του callback σας |
Τα αποκτάτε ολοκληρώνοντας την πρόκληση σε /token/ |
| Ξεκινήστε με | Iframe: frontend | OAuth: backend |
Οι περισσότεροι πελάτες ιστού χρησιμοποιούν iframe.
Προγραμματίζετε με βοηθό AI; Εγκαταστήστε το Wealth Reader δεξιότητα σε Claude Code, Codex, Cursor, Copilot ή Gemini CLI και δημιουργεί την ενοποίηση ακολουθώντας αυτόν τον οδηγό.
Πώς λειτουργεί (iframe)
- Η σελίδα σας φορτώνει το γραφικό στοιχείο με ένα
operation_idπου δημιουργείτε. - Ο χρήστης επιλέγει την οντότητα, δίνει τη συγκατάθεσή του και επιλύει τους δύο παράγοντες εάν είναι απαραίτητο. Το γραφικό στοιχείο διαχειρίζεται αυτά τα βήματα.
- Wealth Reader λαμβάνει τα δεδομένα και κάνει δύο πράγματα, με αυτή τη σειρά:
- Στο backend, η Wealth Reader στέλνει το πλήρες JSON στη διεύθυνση URL callback που έχετε ρυθμίσει. Το
operation_idταξιδεύει σε αυτήν την απόκριση, ώστε να μπορείτε να το συσχετίσετε με τη λειτουργία του front-end σας. - Στο frontend, το iframe ειδοποιεί τη σελίδα σας με
postMessage(flow completed) μόνο εάν το callback ανταποκριθεί σωστά. Χρησιμοποιήστε το για να κλείσετε τον επιλογέα ή να εμφανίσετε μια οθόνη επιτυχίας.
- Στο backend, η Wealth Reader στέλνει το πλήρες JSON στη διεύθυνση URL callback που έχετε ρυθμίσει. Το
Το operation_id είναι η γέφυρα μεταξύ εμπρός και πίσω. Χωρίς αυτό, δεν μπορείτε να διασταυρώσετε αυτό που συνέβη στο πρόγραμμα περιήγησης με τα δεδομένα που φτάνουν στον διακομιστή σας.
Το μήνυμα flow completed δεν περιέχει τα τραπεζικά δεδομένα. Τα δεδομένα ταξιδεύουν στο callback. Εάν το callback δεν ανταποκρίνεται HTTP 200 με {"status":"ok"}, το μπροστινό μέρος δεν λαμβάνει flow completed.