Επακόλουθες πράξεις
Όταν χρησιμοποιείτε τη μέθοδο ενοποίησης Hosted Session, η διαδικασία πληρωμής για μια νέα παραγγελία ξεκινά με μια αρχική συναλλαγή, τις περισσότερες φορές μια συναλλαγή PAY ή AUTHORIZE. Για μια πλήρη λίστα με τις διαθέσιμες αρχικές συναλλαγές, βλ. Συναλλαγές.
Η αρχική συναλλαγή ορίζει όλες τις σημαντικές πληροφορίες για την παραγγελία, περιλαμβάνει:
- Λεπτομέρειες σχετικά με την ίδια την παραγγελία (όπως αναγνωριστικό, ποσό και νόμισμα).
- Τρόπος πληρωμής που θα χρησιμοποιηθεί για την πληρωμή.
- Στοιχεία πληρωμής του πληρωτή.
Αν χρησιμοποιείτε μια συναλλαγή PAY και ο πληρωτής λάβει τα αγαθά που παρήγγειλε και είναι ευχαριστημένος με αυτά, η παραγγελία έχει ολοκληρωθεί και δεν χρειάζονται άλλες ενέργειες. Ωστόσο, σε πολλά σενάρια μπορεί να χρειαστούν μεταγενέστερες συναλλαγές για τη διαχείριση του υπολειπόμενου κύκλου ζωής της παραγγελίας.
Μεταγενέστερα σενάρια
Τα ακόλουθα σενάρια είναι παραδείγματα καταστάσεων όπου πρέπει να στείλετε επακόλουθες συναλλαγές για την υπάρχουσα παραγγελία σας:
- Αν χρησιμοποιείτε μια συναλλαγή
VERIFY, η οποία δημιουργείται συχνά με μηδενικό ποσό παραγγελίας, ως την αρχική συναλλαγή για την επαλήθευση των λεπτομερειών του λογαριασμού του πληρωτή, θα πρέπει να χρησιμοποιήσετε επακόλουθα μια συναλλαγήPAYήAUTHORIZEγια να καθορίσετε το σωστό ποσό παραγγελίας και να ξεκινήσετε η μεταφορά χρημάτων. - Αν χρησιμοποιείτε μια συναλλαγή
AUTHORIZEως αρχική συναλλαγή, θα πρέπει να χρησιμοποιήσετε επακόλουθα μια συναλλαγήCAPTURE, όταν είστε έτοιμοι να στείλετε τα εμπορεύματα και θέλετε να εισπράξετε τα χρήματα. Αν υπάρξει καθυστέρηση στην αποστολή των αγαθών, ίσως χρειαστεί επίσης να χρησιμοποιήσετε τη συναλλαγήUPDATE AUTHORIZATIONγια να διατηρήσετε την έγκριση ενεργή μέχρι να είστε έτοιμοι να τη δεσμεύσετε. - Αν η παραγγελία ακυρωθεί για οποιονδήποτε λόγο, πρέπει να χρησιμοποιήσετε τη συναλλαγή
VOIDγια να την ακυρώσετε αμέσως και στην πύλη. Αν οι λεπτομέρειες πληρωμής έχουν ήδη σταλεί στην τράπεζα, πρέπει να χρησιμοποιήσετε τη συναλλαγήVOIDγια να την ακυρώσετε αμέσως και στην πύλη. Αν οι λεπτομέρειες πληρωμής έχουν ήδη αποσταλεί στην τράπεζα, πρέπει να χρησιμοποιήσετε τη συναλλαγήREFUND, η οποία είναι επίσης απαραίτητη σε περίπτωση που ο πληρωτής δεν είναι ευχαριστημένος με την αγορά του και θέλει να την επιστρέψει. Στη σπάνια περίπτωση που η συναλλαγή αποτύχει επειδή η τράπεζα εμπόρου χρειάζεται περαιτέρω έγκριση, μπορείτε να χρησιμοποιήσετε μια συναλλαγήREFUND, η οποία είναι επίσης απαραίτητη σε περίπτωση που ο πληρωτής δεν είναι ευχαριστημένος με την αγορά του και θέλει να την επιστρέψει. Στη σπάνια περίπτωση που η συναλλαγή αποτύχει επειδή η τράπεζα εμπόρου χρειάζεται περαιτέρω έγκριση, μπορείτε να χρησιμοποιήσετε μια συναλλαγήREFERRALγια να δοκιμάσετε ξανά την πράξη πληρωμής με τις απαραίτητες πρόσθετες λεπτομέρειες.
Οι πράξεις API RETRIEVE TRANSACTION και RETRIEVE ORDER μπορούν επίσης να θεωρηθούν επακόλουθες συναλλαγές, αν και χρησιμοποιούνται μόνο για την ανάκτηση λεπτομερειών μιας υπάρχουσας παραγγελίας και δεν επηρεάζουν τον κύκλο ζωής της παραγγελίας. Για μια λίστα με όλες τις διαθέσιμες επακόλουθες συναλλαγές, βλ. "Συναλλαγές".
Σύνδεση με την αρχική συναλλαγή
Όλες οι συναλλαγές που σχετίζονται με την ίδια παραγγελία πρέπει να συνδέονται, ώστε τα διάφορα συστήματα πληρωμών, όπως το Mastercard Gateway και οι τράπεζες, να μπορούν να αναγνωρίσουν ότι ανήκουν μαζί. Η σύνδεση γίνεται χρησιμοποιώντας το ίδιο order ID σε κάθε συναλλαγή που σχετίζεται με την παραγγελία. Το order ID παρέχεται ως παράμετρος διαδρομής στη διεύθυνση URL αιτήματος.
Δεδομένα που κοινοποιούνται σε επακόλουθες συναλλαγές
Η σύνδεση διαφορετικών συναλλαγών εντός της ίδιας παραγγελίας σημαίνει ότι χρειάζεται να παρέχετε συγκεκριμένα δεδομένα σχετικά με την παραγγελία μόνο μία φορά. Η πύλη αποθηκεύει τις λεπτομέρειες της παραγγελίας και μπορεί να τις χρησιμοποιήσει όπως απαιτείται, κατά την επεξεργασία τυχόν επακόλουθων συναλλαγών.
Σε κάθε επακόλουθη συναλλαγή, χρειάζεται μόνο να παρέχετε τα δεδομένα που αφορούν τη συγκεκριμένη συναλλαγή. Για παράδειγμα:
- Σε μια συναλλαγή
CAPTURE, παρέχετε το ποσό και το νόμισμα για τα αγαθά που στέλνετε σε εκείνο το σημείο, που μπορεί να είναι το πλήρες ή μερικό ποσό της παραγγελίας. - Σε μια συναλλαγή
REFUND, δώστε το ποσό και το νόμισμα για την επιστροφή χρημάτων που στέλνετε, που μπορεί να είναι το πλήρες ή μερικό ποσό της παραγγελίας. - Σε μια συναλλαγή
VOID, δώστε το αναγνωριστικό συναλλαγής της ακριβούς συναλλαγής που θέλετε να ακυρώσετε. - Σε μια συναλλαγή
REFERRAL, δώστε τον κωδικό έγκρισης που επιτρέπει στον εκδότη να εγκρίνει τη συναλλαγή που απέτυχε προηγουμένως.
Αν παρέχετε πανομοιότυπες πληροφορίες σε πολλές συναλλαγές σε μια παραγγελία, η πύλη τις αγνοεί. Αν ενημερώσετε οποιαδήποτε πληροφορία σε μια επακόλουθη συναλλαγή, η πύλη ενημερώνει τις λεπτομέρειες της παραγγελίας αναλόγως. Για παράδειγμα, πρώτα δώσατε μια διεύθυνση αποστολής στην αρχική συναλλαγή AUTHORIZE και ο πληρωτής μετακομίζει. Στη συνέχεια, μπορείτε να προσθέσετε μια νέα διεύθυνση αποστολής στη συναλλαγή CAPTURE.