- Κατευθυντήριες οδηγίες ενοποίησης
- Υποστηριζόμενες δυνατότητες (Άλλες δυνατότητες)
- Ειδοποιήσεις Webhook
Ειδοποιήσεις Webhook
Η συνδρομή στις ειδοποιήσεις Webhook σας δίνει τη δυνατότητα να λαμβάνετε ειδοποιήσεις στο σύστημά σας όταν δημιουργείται ή ενημερώνεται μια συναλλαγή για μια παραγγελία στην πύλη. Αυτό σας δίνει επίσης τη δυνατότητα να ενημερώσετε το σύστημα του καταστήματός σας αντίστοιχα. Η ειδοποίηση Webhook περιέχει την απόκριση της πράξης Retrieve Transaction.
Ειδοποιήσεις Webhook με ενοποιήσεις στο Hosted Checkout
Για τις ενοποιήσεις Hosted Checkout, αν χρησιμοποιείτε το API ταυτοποίησης για ταυτοποίηση 3-D Secure, θα λάβετε δύο ειδοποιήσεις Webhook, σε σύγκριση με μία αν χρησιμοποιείτε τη λειτουργία 3DS1.
- Ένα αφού ολοκληρωθεί η ταυτοποίηση πληρωτή
- Ένα αφού ολοκληρωθεί η συναλλαγή Authorization/Pay
Το Webhook ταυτοποίησης πληρωτή θα περιλαμβάνει μόνο λεπτομέρειες της πράξης ταυτοποίησης. Δεν θα περιλαμβάνει πληροφορίες σχετικά με το αποτέλεσμα της οικονομικής συναλλαγής. Το Webhook Authorization/Pay θα περιλαμβάνει το αποτέλεσμα της διεκπεραίωσης της οικονομικής συναλλαγής.
Διαμόρφωση ειδοποιήσεων Webhook
Μπορείτε να διαμορφώσετε τις ακόλουθες παραμέτρους για τις ειδοποιήσεις Webhook στο Merchant Administration:
- Διεύθυνση URL ειδοποίησης—Μπορείτε να διαμορφώσετε μια καθολική διεύθυνση URL στο Merchant Administration για να λαμβάνετε ειδοποιήσεις για όλες τις ενημερώσεις συναλλαγών σε αυτήν τη διεύθυνση URL. Αν επιθυμείτε να αντικαταστήσετε την καθολική διεύθυνση URL βάσει συναλλαγής, συμπληρώστε τη διεύθυνση URL στο πεδίο
order.notificationUrlστο αίτημα συναλλαγής σας. Με τις επακόλουθες συναλλαγές, οι ειδοποιήσεις αποστέλλονται στη διεύθυνση URL (αν έχει δοθεί) στη συναλλαγή ή στη διεύθυνση URL που χρησιμοποιήθηκε τελευταία φορά για την παραγγελία. - Η Μορφή API—Mastercard Gateway στέλνει ειδοποιήσεις Webhook στη μορφή (REST ή NVP) που διαμορφώνετε στο Merchant Administration.
Διασφάλιση της ακεραιότητας των ειδοποιήσεων Webhook
Αν βασίζεστε στο περιεχόμενο της ειδοποίησης Webhook για λόγους που είναι κρίσιμοι για την επιχείρηση, μπορείτε να ακολουθήσετε τα παρακάτω βήματα για να διασφαλίσετε την ακεραιότητα των δεδομένων που λαμβάνετε στις ειδοποιήσεις.
- Παρέχετε μια ασφαλή διεύθυνση URL (https://) ως τελικό σημείο και
- Ελέγξτε το Μυστικό ειδοποίησης
Το Μυστικό ειδοποίησης είναι μια τυχαία συμβολοσειρά 32 χαρακτήρων που δημιουργείται από την πύλη. Το μυστικό εμφανίζεται στο Merchant Administration αν έχετε διαμορφώσει τις Ειδοποιήσεις Webhook. Για ασφαλείς διευθύνσεις URL μόνο (https://), η πύλη θα συμπεριλάβει το μυστικό στην κεφαλίδα X-Notification-Secret μαζί με το μήνυμα.
Εναλλακτικά, μπορείτε να εκτελέσετε μια πράξη Retrieve Transaction χρησιμοποιώντας τα αναγνωριστικά στη ληφθείσα ειδοποίηση για να λάβετε τις τροποποιημένες λεπτομέρειες.
Αποδοχή ειδοποιήσεων Webhook
Η πύλη θα θεωρήσει την παράδοση της ειδοποίησης Webhook ως επιτυχή αν το σύστημά σας ανταποκριθεί με ένα μήνυμα επιτυχούς επιβεβαίωσης που περιέχει τον κωδικό κατάστασης HTTP 200 εντός 2 δευτερολέπτων.
Η πύλη προσπαθεί να στέλνει ειδοποιήσεις με την ίδια ακολουθία με την οποία πραγματοποιήθηκαν οι ενημερώσεις στις συναλλαγές εκτός αν η ειδοποίηση απαιτεί επανάληψη της παράδοσης. Η επανάληψη της παράδοσης πραγματοποιείτε όταν η αρχική ειδοποίηση δεν έχει παραδοθεί επιτυχώς ή το μήνυμα επιβεβαίωση δεν ληφθεί επιτυχώς. Σε αυτές τις περιπτώσεις, η πύλη επιχειρεί να παραδώσει ξανά τις ειδοποιήσεις έως και 20 φορές εντός 3 ημερών αφού παρουσιάστηκε το συμβάν. Αυτό μπορεί να έχει ως αποτέλεσμα την αποστολή διπλότυπων ειδοποιήσεων στο σύστημά σας. Μπορείτε να χρησιμοποιήσετε τα ακόλουθα πεδία στην ειδοποίηση Webhook για τον χειρισμό των ειδοποιήσεων που έχουν παραδοθεί ξανά:
- Η κεφαλίδα X-Notification-Id προσδιορίζει μοναδικά την ειδοποίηση. Αυτή η κεφαλίδα θα είναι πανομοιότυπη για τις διπλότυπες συναλλαγές.
- Η κεφαλίδα X-Notification-Attempt υποδεικνύει τον αριθμό των προσπαθειών που έγιναν για την αποστολή της ειδοποίησης.