Ακύρωση παραγγελίας API όταν ο πελάτης έστειλε λανθασμένο σύνδεσμο

Ελέγξτε πρώτα αν η παραγγελία έχει διαβιβαστεί στον πάροχο

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

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

Προσδιορίστε την κατάσταση της παραγγελίας στον πάροχο

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

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

Το μειονέκτημα του ελέγχου μόνο μέσω εσωτερικής κατάστασης είναι ότι μπορεί να ενημερώνεται με καθυστέρηση. Βασιστείτε στην τελευταία απάντηση API και στον χρόνο λήψης της.

Ακυρώστε την παραγγελία πριν από την έναρξη της υπηρεσίας

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

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

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

Μην αλλάζετε τον σύνδεσμο σε ήδη δημιουργημένη παραγγελία χωρίς επιβεβαίωση

Σε πολλά API ο σύνδεσμος καθορίζεται τη στιγμή της δημιουργίας της παραγγελίας. Η προσπάθεια διαβίβασης νέου συνδέσμου με το ίδιο αναγνωριστικό μπορεί να αγνοηθεί, να αντιμετωπιστεί ως σφάλμα ή να δημιουργήσει απρόβλεπτη κατάσταση. Μην υπολογίζετε ότι η εκ νέου αποστολή του αιτήματος θα αντικαταστήσει αυτόματα τη διεύθυνση.

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

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

Τι να κάνετε σε περίπτωση μερικής εκτέλεσης

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

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

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

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

Μια ολοκληρωμένη παραγγελία συνήθως δεν μπορεί να ακυρωθεί μέσω API. Σε αυτή την περίπτωση μην διαγράψετε την εγγραφή και μην αλλάξετε τον σύνδεσμο στο ιστορικό: τα αρχικά δεδομένα χρειάζονται για επαλήθευση. Ελέγξτε αν η υπηρεσία παρασχέθηκε πράγματι στη λανθασμένη διεύθυνση και όχι αν απλώς εμφανίζεται με καθυστέρηση.

Στη συνέχεια υπάρχουν δύο δρόμοι: να συζητήσετε αποζημίωση με τον πάροχο σύμφωνα με τους κανόνες του ή να δημιουργήσετε νέα παραγγελία στον σωστό σύνδεσμο αφού συνεννοηθείτε με τον πελάτη. Η νέα παραγγελία πρέπει να έχει ξεχωριστό αναγνωριστικό, ποσό και σαφή σημείωση για τον λόγο δημιουργίας.

Το μειονέκτημα της νέας εκκίνησης είναι ότι απαιτεί πρόσθετο προϋπολογισμό, ενώ η αποζημίωση για ολοκληρωμένη υπηρεσία μπορεί να μην είναι διαθέσιμη.

Ενημερώστε τον πελάτη για την κατάσταση πριν από τη νέα εκκίνηση

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

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

Το μειονέκτημα της μακράς συνεννόησης είναι ότι στο μεταξύ η παραγγελία στην ουρά μπορεί να περάσει σε επεξεργασία. Γι' αυτό στείλτε πρώτα το τεχνικό αίτημα ακύρωσης, αν υπάρχει τέτοια δυνατότητα, και στη συνέχεια διευκρινίστε τις περαιτέρω ενέργειες.

Διατηρήστε αρχεία καταγραφής και αποδεικτικά στοιχεία για τη λειτουργία

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

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

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

Ελέγξτε τη διαχείριση σφαλμάτων στην ενσωμάτωση

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

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

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

Ρυθμίστε μια σαφή διαδικασία ακύρωσης για την ομάδα

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

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

Το μειονέκτημα της αυστηρής διαδικασίας είναι η μικρότερη ευελιξία σε επείγουσες περιπτώσεις. Για τις παραγγελίες API όμως σημασία έχει όχι τόσο η ταχύτητα μιας μεμονωμένης ενέργειας, όσο ο έλεγχος του ποιος σύνδεσμος πήγε πραγματικά σε εκτέλεση.