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