Developers API & Widget
API Reference
EL

Πρώτα βήματα

Εισαγωγή

Αυτός ο οδηγός εξηγεί πώς να ενσωματώσετε το 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)

  1. Η σελίδα σας φορτώνει το widget με ένα operation_id που δημιουργείτε εσείς.
  2. Ο χρήστης επιλέγει το ίδρυμα, δίνει συγκατάθεση και ολοκληρώνει την επαλήθευση δύο παραγόντων αν χρειάζεται. Το widget διαχειρίζεται αυτά τα βήματα.
  3. Το Wealth Reader ανακτά τα δεδομένα και κάνει δύο πράγματα, με αυτή τη σειρά:
    • Στο backend, στέλνει το πλήρες JSON στο URL callback που έχετε ρυθμίσει. Το operation_id ταξιδεύει σε αυτή την απόκριση ώστε να το αντιστοιχίσετε με τη λειτουργία του frontend.
    • Στο frontend, το iframe ειδοποιεί τη σελίδα σας με postMessage (flow completed) μόνο αν το callback πέτυχε. Χρησιμοποιήστε το για να κλείσετε τον επιλογέα ή να εμφανίσετε οθόνη επιτυχίας.

Το operation_id είναι η γέφυρα μεταξύ frontend και backend. Χωρίς αυτό δεν μπορείτε να αντιστοιχίσετε ό,τι συνέβη στο πρόγραμμα περιήγησης με τα δεδομένα που φτάνουν στον διακομιστή σας.

Το μήνυμα flow completed δεν περιέχει τα τραπεζικά δεδομένα. Τα δεδομένα πηγαίνουν στο callback. Αν το callback δεν απαντήσει HTTP 200 με {"status":"ok"}, το frontend δεν λαμβάνει flow completed.

Τελευταία ενημέρωση