Ενημέρωση για τους αναγνωριστικούς κωδικούς API

Ως μέρος των προσπαθειών της Mollie για τη βελτίωση της αξιοπιστίας και της ασφάλειας των συστημάτων μας, εργαζόμαστε για την ενοποίηση των αναγνωριστικών πόρων API μας υπό ένα νέο πρότυπο - οι κωδικοί αναγνώρισης πληρωμών και παραγγελιών είναι οι επόμενοι. 

 

Τι εξελίσσεται;

Ιστορικά, οι κωδικοί αναγνώρισης API μας περιελάμβαναν 10 χαρακτήρες ή λιγότερο (χωρίς το πρόθεμα, παράδειγμα: tr_XYZXYZXYZX). Από τις αρχές της χρονιάς, αναβαθμίζουμε αυτούς τους κωδικούς αναγνώρισης κληρονομιάς σε μια μεγαλύτερη μορφή, προσθέτοντας 4 έως 12 χαρακτήρες επιπλέον.

Οι νεότεροι πόροι - όπως οι Κατασχέσεις και οι Σύνδεσμοι Πληρωμής - εισήχθησαν χρησιμοποιώντας αυτή τη διευρυμένη μορφή από την αρχή. Οι Επιστροφές χρημάτων, ένας παλαιότερος πόρος, αναβαθμίστηκαν πρόσφατα για να υιοθετήσουν τη νέα μορφή.

Στη συνέχεια, αυτή η αλλαγή θα εφαρμοστεί στους πιο κρίσιμους πόρους μας: Πληρωμές (Δημιουργία πληρωμής -> Response -> ID) και Παραγγελίες (Δημιουργία παραγγελίας -> Response -> ID). 

 

Τι σημαίνει αυτό για εσάς;

Αν χρησιμοποιείς μία από τις έτοιμες ενσωματώσεις μας, όπως WooCommerce, Shopify ή Magento 2, δεν θα δεις καμία επίδραση από αυτή την αλλαγή. Εξετάσαμε αυτές τις ενσωματώσεις και δεν εντοπίσαμε προβλήματα συμβατότητας. 

Ωστόσο, αν έχετε μια προσαρμοσμένη ενσωμάτωση με την Mollie και/ή πρόσθετες downstream ενσωματώσεις που διαχειρίζονται αυτές τις αναφορές πληρωμής (για παράδειγμα, ERPs, διαχείριση παραγγελιών ή λογιστικά συστήματα), παρακαλώ πάρτε μια στιγμή να εξετάσετε τα εξής:

  • Αποθήκευση βάσης δεδομένων: Αν αποθηκεύετε αυτούς τους αναγνωριστικούς κωδικούς, βεβαιωθείτε ότι το μήκος του πεδίου δεν περιορίζεται σε μόνο 10 χαρακτήρες. Συστήνουμε μήκος πεδίου τουλάχιστον 40 χαρακτήρες ή περισσότερους για την ασφάλεια του μέλλοντος.
  • Προσαρμοσμένη επικύρωση: Βεβαιωθείτε ότι οποιαδήποτε προσαρμοσμένη επικύρωση αναγνωριστικού που έχετε μπορεί να φιλοξενήσει τη μακρύτερη μορφή. Συστήνουμε ότι αν αποφασίσετε να επικυρώσετε τη μορφή του κωδικού, να ελέγξετε μόνο ότι το πρόθεμα ταιριάζει με τις προσδοκίες σας και να αποφύγετε την επικύρωση του υπολοίπου του κωδικού.

Αυτή η ενημέρωση δεν θα πρέπει να διαταράξει την επεξεργασία πληρωμών, αλλά η λανθασμένη διαχείριση των νέων αναγνωριστικών θα μπορούσε να οδηγήσει σε διαφορές. Μπορείς να βρεις περισσότερες πληροφορίες για το νέο πρότυπο εδώ.

 

Ετοιμαστείτε για μια δοκιμαστική συναλλαγή:

Θα εκτελέσουμε μια μοναδική δοκιμαστική συναλλαγή για κάθε μοναδικό προφίλ/χρήστη_agent/client_id συνδυασμό χρησιμοποιώντας τους νέους κωδικούς αναγνώρισης API στις 5 Ιουνίου, ξεκινώντας στις 2 πμ CET. Ως εκ τούτου, δρομολογούμε την πρώτη συναλλαγή που γίνεται για να χρησιμοποιήσει τη νέα μορφή κωδικού. Όλες οι επόμενες συναλλαγές θα χρησιμοποιήσουν ξανά το παλιό πρότυπο, μέχρι να ξεκινήσουμε την κυκλοφορία στις 12 Ιουνίου.
Αν προκύψουν οποιαδήποτε προβλήματα μετά αυτή τη δοκιμή, θα σας δώσουμε την επιλογή να αποχωρήσετε προσωρινά από την αλλαγή. Θα σας στείλουμε ένα email σχετικά με τη διαδικασία αποχώρησης στις 6 Ιουνίου

Επίλυση προβλημάτων
Σε περίπτωση που τα συστήματά σας αντιμετωπίσουν ξαφνικά προβλήματα με την επεξεργασία του νέου κωδικού, μπορείτε να διαχειριστείτε τη συναλλαγή (π.χ. ακυρώστε/επιστρέψτε/κατασχέστε) χειροκίνητα στο Mollie Dashboard πηγαίνοντας στις Παραγγελίες/Πληρωμές, επιλέγοντας τη σχετική συναλλαγή και εκτελώντας την επιθυμητή ενέργεια εκεί. 

 

Σημείωση: Φιλοξενούμε μια συνεδρία ερωτήσεων & απαντήσεων στις 2 Ιουνίου στο Discord. Επιπλέον, μπορείς να κάνεις οποιαδήποτε ερώτηση σε αυτό το κανάλι Discord

Χρονοδιαγράμματα:

  • 2 Ιουνίου: Συνεδρία ερωτήσεων & απαντήσεων - Έλα μαζί μας στο Discord
  • 5 Ιουνίου: Μοναδική Δοκιμαστική Συναλλαγή ανά μοναδικό προφίλ/χρήστη-agent/client_id συνδυασμό
  • 6 Ιουνίου: Ακολουθητικό email, με επιλογή να αποχωρήσετε προσωρινά από την αλλαγή του νέου κωδικού
  • 12 Ιουνίου: Αρχή της σταδιακής κυκλοφορίας της νέας μορφής κωδικού (εξαιρ. αποχωρήσεις) 
  • 8 Ιουλίου: 100% κυκλοφορία της νέας μορφής κωδικού (εξαιρ. αποχωρήσεις)
  • 31 Δεκεμβρίου: Τέλος της περιόδου εξαίρεσης, μετεγκατάσταση όλων των υπόλοιπων προφίλ.