Η χρήση περιόδων λειτουργίας επιτρέπει πιο σύνθετες ενοποιήσεις, όπου τα διάφορα μέρη του αιτήματος δεσμεύονται σε διαφορετικά σημεία της ροής πληρωμών ή μέσω διαφορετικών καναλιών. Για παράδειγμα, οι ροές πληρωμών τόσο για Hosted Session όσο και για πορτοφόλια (για παράδειγμα Masterpass) χρησιμοποιούν περιόδους λειτουργίας για τη συλλογή και την αποθήκευση ευαίσθητων πληροφοριών πληρωτών. Αυτό μειώνει το κόστος συμμόρφωσης για PCI και υλοποίησης, καθώς δεν χρειάζεται να χειρίζεστε ή να αποθηκεύετε λεπτομέρειες πληρωμής στον διακομιστή σας.
Εργασία με συνεδρίες
Δημιουργία περιόδου λειτουργίας
Ως πρώτο βήμα, πρέπει να δημιουργήσετε μια περίοδο λειτουργίας (session), την οποία μπορείτε στη συνέχεια να ενημερώσετε με τα πεδία αιτήματος και τις τιμές που θέλετε να αποθηκεύσετε στην περίοδο λειτουργίας.
Μπορείτε να δημιουργήσετε μια περίοδο λειτουργίας χρησιμοποιώντας:
Ενημέρωση μιας περιόδου λειτουργίας
Μπορείτε να προσθέσετε ή να ενημερώσετε πεδία αιτήματος σε μια περίοδο λειτουργίας χρησιμοποιώντας:
Δεν μπορείτε να καταργήσετε πεδία από μια περίοδο λειτουργίας, αλλά μπορείτε να αντικαταστήσετε τιμές μόνο για τα υπάρχοντα πεδία.
Χρήση περιόδου λειτουργίας
Μια περίοδος λειτουργίας που περιέχει τα πεδία αιτήματος και τις τιμές μπορεί να χρησιμοποιηθεί σε οποιαδήποτε από τις παρακάτω πράξεις:
Συνιστάται η ανάκτηση των λεπτομερειών της περιόδου λειτουργίας (session) χρησιμοποιώντας την πράξη Retrieve Session και ο έλεγχος των περιεχομένων της περιόδου λειτουργίας προτού ξεκινήσετε μια πράξη payment ή tokenization.
Μπορείτε να εκτελέσετε πολλές πράξεις χρησιμοποιώντας την ίδια περίοδο λειτουργίας, για παράδειγμα Pay και Tokenization. Αυτό είναι χρήσιμο αν επιθυμείτε να εκτελέσετε μια πληρωμή και επίσης να αποθηκεύσετε τα στοιχεία της κάρτας. Λάβετε υπόψη ότι η έκδοση Web-Services API για τις πράξεις που κάνουν αναφορά στην περίοδο λειτουργίας θα πρέπει να αντιστοιχεί στην έκδοση Web-Services API που χρησιμοποιήθηκε κατά την ενημέρωση ή την προσθήκη των πεδίων αιτήματος στη συγκεκριμένη περίοδο λειτουργίας.
Αφού ξεκινήσετε μια πράξη που κάνει αναφορά σε μια περίοδο λειτουργίας (εκτός από Open Wallet, Update Session, Update Session From Wallet), ο κωδικός ασφαλείας κάρτας, εφόσον έχει αποθηκευτεί στην περίοδο λειτουργίας, καταργείται. Αυτό είναι απαραίτητο για συμμόρφωση με τους κανονισμούς PCI. Αν θέλετε να αποθηκεύσετε τα στοιχεία της κάρτας για μεταγενέστερη χρήση, μπορείτε να το κάνετε εκτελώντας την πράξη Tokenization χρησιμοποιώντας την περίοδο λειτουργίας.
Κανόνες προτεραιότητας
Κατά την υποβολή ενός αιτήματος πράξης, χρησιμοποιούνται τα πεδία και οι τιμές του αιτήματος που αποθηκεύονται για μια περίοδο λειτουργίας μόνο αν δεν τα καταχωρίσετε απευθείας στο αίτημα.
Ανάκτηση πεδίων από μια περίοδο λειτουργίας
Μπορείτε να ανακτήσετε τα πεδία αιτήματος και τις τιμές που έχουν αποθηκευτεί σε μια περίοδο λειτουργίας παρέχοντας το ID περιόδου λειτουργίας.
Retrieve Session - Αναφορά API[REST][NVP]
Λήψη επιχειρηματικών αποφάσεων βάσει περιεχομένου περιόδου λειτουργίας
Αν λαμβάνετε επιχειρηματικές αποφάσεις βάσει δεδομένων που προέρχονται από μια περίοδο λειτουργίας θα πρέπει να χρησιμοποιήσετε τη δυνατότητα αισιόδοξου κλειδώματος της περιόδου λειτουργίας. Αυτό εξασφαλίζει ότι τα δεδομένα που χρησιμοποιήσατε για να λάβετε τις αποφάσεις σας είναι τα ίδια με αυτά που χρησιμοποιήσατε για τη διεκπεραίωση του αιτήματος πράξης.
Για να χρησιμοποιήσετε τη δυνατότητα αισιόδοξου κλειδώματος, θα πρέπει να:
- Ανακτήσετε με ασφάλεια το περιεχόμενο της περιόδου λειτουργίας χρησιμοποιώντας την πράξη
Retrieve Session.
- Καταγράψετε την τιμή
session.version στο περιεχόμενο της περιόδου λειτουργίας που επιστρέφεται.
- Λάβετε τις επιχειρηματικές σας αποφάσεις βάσει του περιεχομένου περιόδου λειτουργίας που επιστρέφεται.
- Κατά την υποβολή του αιτήματος πράξης στην πύλη, διαβιβάστε το
session.version μαζί με το αναγνωριστικό της περιόδου λειτουργίας στο πλαίσιο της πράξης.
Αν το περιεχόμενο της περιόδου λειτουργίας έχει αλλάξει από τότε που καταγράψατε το session.version, η πύλη θα απορρίψει την πράξη και θα επιστρέψει error.cause=INVALID_REQUEST.
Παραδείγματα επιχειρηματικών αποφάσεων που λαμβάνονται βάσει του περιεχομένου περιόδου λειτουργίας περιλαμβάνουν:
- Τον υπολογισμό του πρόσθετου τέλους βάσει του τύπου κάρτας που παρέχεται από τον πληρωτή.
- Τον υπολογισμό του ποσού αποστολής βάσει της διεύθυνσης αποστολής που παρέχεται από τον πληρωτή.
Retrieve Session - Αναφορά API[REST][NVP]
Pay[REST][NVP]