MyBankMatch

Προετοιμασία της σύνδεσης

1. Διαθέστε ενεργή άδεια χρήσης με το προϊόν MY_BANK_MATCH και διαθέσιμο όριο χρήσης.
2. Ανοίξτε το Πελάτες · MyBankMatch με πιστοποιημένη συνεδρία και την αντίστοιχη άδεια χρήσης.
3. Πατήστε Connect bank και ολοκληρώστε τον έλεγχο ταυτότητας στο παράθυρο που φιλοξενεί η Wealthreader. Η σύνδεση με token συσχετίζεται με το api_key σας· το τραπεζικό token δεν παραδίδεται στο πρόγραμμα περιήγησης ούτε αποτελεί παράμετρο ερωτήματος.
4. Ανανεώστε την κατάσταση στους Πελάτες. Αν η τράπεζα απαιτεί νέο έλεγχο ταυτότητας, χρησιμοποιήστε το Reconnect. Ο πίνακας προσφέρει επίσης ρητή δοκιμή IBAN/ονόματος και τα τελευταία ερωτήματα με μάσκα.

Ο εκδότης χρησιμοποιεί έναν υπογεγραμμένο σύνδεσμο μίας χρήσης και μια συνέχεια συνδεδεμένη με το πρόγραμμα περιήγησης. Αν ο σύνδεσμος έχει λήξει ή χαθεί αυτή η συνέχεια, ζητήστε νέο από τους Πελάτες.

Αποστολή ερωτήματος από το backend

POST https://api.wealthreader.com/my-bank-match/
Content-Type: application/x-www-form-urlencoded

Δεν αποστέλλεται JSON ούτε χρησιμοποιείται X-API-Key: το κλειδί αποτελεί μέρος του σώματος που κωδικοποιείται ως φόρμα, όπως και στο /entities/.

curl --request POST 'https://api.wealthreader.com/my-bank-match/' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'api_key=<SU_API_KEY>' \
  --data-urlencode 'iban=ES9321005707250200257112' \
  --data-urlencode 'name=Wealthreader S.L.'

Το <SU_API_KEY> είναι δείκτης θέσης, όχι χρησιμοποιήσιμο κλειδί. Το IBAN και το όνομα απεικονίζουν το αίτημα αποδοχής· δεν έχει επαληθευτεί εδώ ότι παράγουν συγκεκριμένη ετυμηγορία. Το ερώτημα μπορεί να χρεώνεται: μην το εκτελείτε ως αυτόματη ανανέωση της διεπαφής.

Το MyBankMatch επιστρέφει την ετυμηγορία της τράπεζας. Δεν αντικαθιστά αυτή την απάντηση με τοπικό υπολογισμό ομοιότητας ονομάτων. Επίσης, δεν δημιουργεί, δεν εξουσιοδοτεί ούτε εκτελεί εντολή πληρωμής.

Ερμηνεία της απάντησης

Το HTTP 200 δείχνει ότι λήφθηκε αποτέλεσμα από το προϊόν, όχι ότι το όνομα ταιριάζει απαραίτητα. Ελέγξτε το success και στη συνέχεια το payload.result.

Ενδεικτικό παράδειγμα μερικής αντιστοίχισης (προσομοιωμένα όνομα και SESSION):

{
  "success": true,
  "payload": {
    "result": "PARTIAL_MATCH",
    "suggested_name": "TITULAR DE EJEMPLO S.L."
  },
  "statistics": {
    "SESSION": "0000000000000000",
    "execution_time": 0.42,
    "warnings": []
  }
}

Το statistics.SESSION προσδιορίζει αυτό το ερώτημα για διαγνωστικούς σκοπούς και το execution_time εκφράζεται σε δευτερόλεπτα. Μια επιτυχής απάντηση δεν περιλαμβάνει αντικείμενο error ούτε επιστρέφει το token της τραπεζικής σύνδεσης.

Σε μερική αντιστοίχιση, εμφανίστε χωριστά το όνομα που καταχωρίστηκε και το suggested_name· μην αντικαθιστάτε σιωπηρά το πρώτο. Αν τα παρουσιάζετε σε HTML, κάντε escape ως κείμενο.

Η διεύθυνση URL προετοιμασίας για NOT_CONFIGURED και REAUTH_REQUIRED είναι:

https://www.wealthreader.com/clients/#my-bank-match

Για παράδειγμα, ένας νέος έλεγχος ταυτότητας μπορεί να επιστρέψει αυτό το payload:

{
  "result": "REAUTH_REQUIRED",
  "setup_url": "https://www.wealthreader.com/clients/#my-bank-match",
  "reason_code": 2000
}

Το reason_code πρέπει να είναι ακέραιος μεταξύ 2000 και 2999· για παράδειγμα, το 2000 αντιστοιχεί σε αποτυχία διαπιστευτηρίων. Συνδεθείτε ξανά από τους Πελάτες αντί να επαναλαμβάνετε επ' αόριστον την επαλήθευση.

Το NOT_POSSIBLE μπορεί να οφείλεται σε προσωρινή μη διαθεσιμότητα, μη έγκυρη τραπεζική απάντηση, έλλειψη χρησιμοποιήσιμου IBAN πληρωτή ή μη διαθέσιμο προσαρμογέα. Διατηρήστε το reason για διάγνωση, αλλά μη μετατρέπετε αυτές τις περιπτώσεις σε επιβεβαίωση κυριότητας ούτε σε αρνητική αντιστοίχιση.

Επικύρωση, όριο χρήσης και σφάλματα

Τα σφάλματα επικύρωσης ή άδειας χρήσης ακολουθούν τη συνήθη δομή απάντησης: success: false, payload, error.code, error.message και statistics με SESSION, διάρκεια και προειδοποιήσεις. Οι ελεγχόμενες επικυρώσεις απαντούν με HTTP 400· το μήνυμα μπορεί να περιλαμβάνει διαγνωστικές πληροφορίες και δεν πρέπει να χρησιμοποιείται ως σταθερό αναγνωριστικό.

Τα σφάλματα εισόδου και τα μη οριστικά αποτελέσματα δεν καταναλώνουν το όριο χρεωνόμενων ερωτημάτων. Το όριο καταναλώνεται όταν η τράπεζα επιστρέφει MATCH, PARTIAL_MATCH ή NO_MATCH· αν μια άλλη κλήση το εξαντλήσει ταυτόχρονα, επιστρέφεται το σφάλμα ορίου αντί να επιβεβαιωθεί το αποτέλεσμα ως επιτυχές.

Η τιμή των 0,10 EUR αφορά αποκλειστικά τα τρία οριστικά αποτελέσματα της σύμβασης. Ο τρόπος χρέωσης ανά ερώτημα και η εξαίρεση των επαληθευμένων συνεδριών σύνδεσης έχουν υλοποιηθεί, αλλά απαιτούν το προηγούμενο σχήμα και την ενεργοποίηση/αναθεώρηση των ερωτημάτων χρέωσης από διαχειριστή· η παρούσα σελίδα δεν πιστοποιεί αυτή την ανάπτυξη. Μόνο μια επαληθευμένη συσχέτιση από τον διακομιστή επιτρέπει την εξαίρεση μιας συνεδρίας από τον τυπικό υπολογισμό διαπιστευτηρίων/προϊόντων: ένα operation_id του προγράμματος περιήγησης δεν αρκεί. Οι απόπειρες που έχουν λήξει, δεν έχουν ελεγχθεί ή είναι ιστορικές χωρίς αυτή την προέλευση δεν έχουν αυτόματη απαλλαγή, ούτε εγγυώνται άλλα δωρεάν αποτελέσματα στον μετρητή.

Όρια αυτής της έκδοσης

• Η επαλήθευση χρησιμοποιεί τη δική σύνδεση του πελάτη με token στη Santander για ιδιώτες. Η πραγματική τραπεζική συμβατότητα δεν έχει ακόμη επικυρωθεί και η δημοσίευση αυτής της σελίδας δεν εγγυάται εμπορική διαθεσιμότητα.
• Η φιλοξενούμενη ροή υποστηρίζει διαπιστευτήρια και προκλήσεις OTP/push, επιλογή μεθόδου και περιορισμένο QR raster. Οι προκλήσεις μέσω script, OAuth, CAPTCHA ή πολλαπλών συμβάσεων δεν έχουν υλοποιηθεί και παράγουν ασφαλές σφάλμα· μπορείτε να ζητήσετε νέο σύνδεσμο από τους Πελάτες.
• Ο πίνακας απαιτεί πιστοποιημένη συνεδρία. Η φόρτωση της κατάστασης, η επιστροφή από το παράθυρο της τράπεζας και η ανανέωση του ιστορικού δεν αποστέλλουν επαληθεύσεις στην τράπεζα: μόνο η ρητή υποβολή της φόρμας εκτελεί ένα ερώτημα που ενδέχεται να χρεωθεί.
• Διατηρήστε το api_key στον διακομιστή σας και μην καταγράφετε διαπιστευτήρια, τραπεζικά tokens ή πλήρη ονόματα σε περιττά αρχεία καταγραφής ενοποίησης. Χρησιμοποιήστε το SESSION για την υποστήριξη και τηρήστε τη διάκριση μεταξύ ετυμηγορίας, σφάλματος και κατάστασης διαμόρφωσης.