- Κατευθυντήριες οδηγίες ενοποίησης
- Υποστηριζόμενες δυνατότητες (πράξεις πληρωμής)
- Πράξεις συναλλαγής
Πράξεις συναλλαγής
Αν έχει γίνει ενοποίηση στην πύλη μέσω DirectAPI, μπορείτε να χρησιμοποιήσετε πράξεις DirectAPI για τη διεκπεραίωση των συναλλαγών, να ανακτήσετε τις λεπτομέρειες των συναλλαγών, να αποθηκεύσετε τις λεπτομέρειες κάρτας κ.λπ. Για να εκτελέσετε μια λειτουργία, πρέπει να έχετε το απαιτούμενο προνόμιο στο προφίλ του εμπόρου σας με την πύλη. Για να ελέγξετε ποιες πράξεις είναι διαθέσιμες για χρήση, επικοινωνήστε με τον your payment service provider.
Πράξεις αρχικής συναλλαγής
Αυτή η ενότητα περιγράφει τις πράξεις που μπορείτε να χρησιμοποιήσετε για να ξεκινήσετε μια συναλλαγή.
Η πράξη Authorize επαληθεύει τις λεπτομέρειες κάρτας του πληρωτή σας, ελέγχει ότι ο πληρωτής σας διαθέτει επαρκή χρήματα στην πιστωτική γραμμή του και επιχειρεί να κρατήσει τα απαιτούμενα χρήματα. Το πιστωτικό όριο του πληρωτή μειώνεται κατά το εγκεκριμένο ποσό και τα χρήματα κρατούνται για μια χρονική περίοδο (στις περισσότερες περιπτώσεις 5-8 ημέρες), όπως καθορίζεται από το πρόγραμμα καρτών και τους κανόνες έκδοσης της κάρτας του πληρωτή.
Η έγκριση δεν χρεώνει χρήματα από τον λογαριασμό του πληρωτή σας, αλλά κρατεί το συνολικό ποσό της παραγγελίας, έτοιμο για να χρεώσει η πράξη Capture την κάρτα και να μεταφέρει τα χρήματα στον λογαριασμό σας. Οι συναλλαγές Authorize δεν εμφανίζονται στην κατάσταση λογαριασμού του πληρωτή, σε αντίθεση με τις συναλλαγές Capture.
Για μια επιτυχημένη έγκριση, η πύλη επιστρέφει το αποτέλεσμα=SUCCESS στην απόκριση συναλλαγής. Μπορείτε να εκτελέσετε μια συναλλαγή Authorize ως επακόλουθη πράξη μόνο αν η αρχική συναλλαγή είναι μια Verify και οι λεπτομέρειες κάρτας στο αίτημα Authorize και τη συναλλαγή Verify ταιριάζουν.
Η συναλλαγή Authorize είναι επίσης γνωστή ως "Auth", "Authorization".
Βεβαιότητα παραγγελίας
Μπορείτε να υποδείξετε ένα επίπεδο βεβαιότητας σχετικά με το ποσό έγκρισης που θα δεσμευθεί με την παροχή του πεδίου order.certainty στο αίτημα Authorize. Για να το κάνετε, πρέπει να έχετε ενεργοποιήσει το δικαίωμα "Αλλαγή βεβαιότητας παραγγελίας" στο προφίλ εμπόρου σας από τον your payment service provider. Μπορείτε να ορίσετε το πεδίο σε κάποια από τις ακόλουθες τιμές:
- FINAL: Το πλήρες εγκεκριμένο ποσό αναμένεται να δεσμευτεί με μία ή περισσότερες δεσμεύσεις εντός της καθορισμένης προθεσμίας (συνήθως 7 ημέρες). Η παραγγελία θα ακυρωθεί μόνο σε εξαιρετικές περιπτώσεις (για παράδειγμα, ο πληρωτής ακύρωσε την αγορά του). Αν δοθεί αυτή η τιμή για τη συναλλαγή σας, μπορεί να δικαιούται χαμηλότερα τέλη διεκπεραίωσης.
- ESTIMATED: Το εγκεκριμένο ποσό είναι μια εκτίμηση του ποσού που θα δεσμευτεί εντός της καθορισμένης προθεσμίας (συνήθως 30-31 ημέρες). Είναι πιθανό το ποσό που έχει δεσμευθεί να είναι λιγότερο ή να μην έχει δεσμευθεί καθόλου, ή η έγκριση μπορεί να έχει ακυρωθεί. Αν δοθεί αυτή η τιμή για τη συναλλαγή σας, μπορεί να σας κοστίσει υψηλότερα τέλη διεκπεραίωσης.
Το αίτημα απορρίπτεται όταν δεν έχετε το δικαίωμα να αλλάξετε τη βεβαιότητα της παραγγελίας και η τιμή που δίνετε σε αυτό το πεδίο δεν αντιστοιχεί στην προεπιλεγμένη τιμή βεβαιότητας παραγγελίας που έχει διαμορφωθεί στο προφίλ εμπόρου σας.
Authorize - Αναφορά API [REST][NVP]
Αντιλογισμοί έγκρισης
Η πύλη μπορεί να αντιλογίσει τα εκκρεμή ποσά έγκρισης για μη δεσμευμένες, εν μέρει δεσμευμένες ή ληγμένες εγκρίσεις, όπου υποστηρίζονται για την τράπεζα εμπόρου. Αυτό σας επιτρέπει να συμμορφώνεστε με τις απαιτήσεις του προγράμματος κάρτας για πλήρεις και μερικούς αντιλογισμούς.
Μη δεσμευμένες εγκρίσεις
Αν δεν θέλετε να δεσμεύσετε το εγκεκριμένο ποσό μετά την υποβολή ενός αιτήματος Authorize, πρέπει να ακυρώσετε την έγκριση υποβάλλοντας ένα αίτημα VOID. Δώστε το ID συναλλαγής για την έγκριση που θα ακυρωθεί στο πεδίο transaction.targetTransactionId.
Εν μέρει δεσμευμένες εγκρίσεις
Όταν υποβάλετε ένα αίτημα Capture για μια παραγγελία, μπορείτε να δώσετε ένα ποσό δέσμευσης μικρότερο από το εγκεκριμένο ποσό για την παραγγελία (order.AuthorizedAmount). Αν δεν σκοπεύετε να δεσμεύσετε το υπόλοιπο εγκεκριμένο ποσό, μπορείτε να ακυρώσετε το υπόλοιπο εγκεκριμένο ποσό, εφόσον υποστηρίζεται για την τράπεζα εμπόρου.
Μπορείτε να επιχειρήσετε να ακυρώσετε/αντιλογήσετε το υπόλοιπο ποσό έγκρισης με δύο τρόπους:
- Υποβάλετε ένα αίτημα VOID με το ID συναλλαγής για την έγκριση που θα ακυρωθεί στο πεδίο
transaction.targetTransactionId. - Δώστε τον αναμενόμενο αριθμό δεσμεύσεων για την παραγγελία στο πεδίο
order.expectedNumberOfCapturesστο αίτημα Capture ή μέσω του Merchant Administration. Σε περίπτωση που ο συνολικός αριθμός των δεσμεύσεων για την παραγγελία (συμπεριλαμβανομένης της τρέχουσας δέσμευσης) υπερβαίνει ή ισούται με τον συνολικό αναμενόμενο αριθμό αιτημάτων Capture, η πύλη θα προκαλέσει αυτόματα μια ακύρωση του υπόλοιπου εγκεκριμένου ποσού, όπου υποστηρίζεται για την τράπεζα εμπόρου. Για να επιτραπεί αυτό, θα πρέπει να έχετε ενεργοποιήσει το δικαίωμα "Αυτόματος αντιλογισμός εκκρεμών ποσών έγκρισης" στο προφίλ εμπόρου από το your payment service provider.
Για παράδειγμα, αν δώσετε την τιμήorder.expectedNumberOfCaptures=2 στο πρώτο αίτημα Capture, τότε η πύλη αντιλογίζει αυτόματα το υπόλοιπο εγκεκριμένο ποσό κατά την επεξεργασία του δεύτερου αιτήματος Capture.
Αν μειώσετε τον αναμενόμενο αριθμό δεσμεύσεων στα επόμενα αιτήματα Capture, π.χ. ενημέρωσηorder.expectedNumberOfCaptures=1 στο δεύτερο αίτημα Capture, τότε η πύλη αντιλογίζει αυτόματα το υπόλοιπο εγκεκριμένο ποσό κατά τη διεκπεραίωση του δεύτερου αιτήματος Capture. Αυτό συμβαίνει επειδή το 2 (ο συνολικός αριθμός δεσμεύσεων για την παραγγελία, συμπεριλαμβανομένης της τρέχουσας δέσμευσης) υπερβαίνει το 1 (τον αναμενόμενο αριθμό δεσμεύσεων). Ωστόσο, αν αυξήσετε τον αναμενόμενο αριθμό δεσμεύσεων στα επόμενα αιτήματα Capture, π.χ. ενημέρωσηorder.expectedNumberOfCaptures=3 στο δεύτερο αίτημα Capture, τότε η πύλη δεν θα αντιλογίσει το υπόλοιπο ποσό μέχρι να λάβει το τρίτο αίτημα Capture.
order.expectedNumberOfCaptures μπορεί να υποβληθεί μόνο από την έκδοση 44 του DirectAPI.Ληγμένες εγκρίσεις
Οι εγκρίσεις έχουν περίοδο ισχύος μετά την οποία λήγουν. Η περίοδος ισχύος της έγκρισης μπορεί να διαμορφωθεί στην πύλη για μια τράπεζα εμπόρου, έναν τύπο κάρτας και έναν συνδυασμό βεβαιότητας παραγγελίας.
Όταν υποβάλλετε ένα αίτημα Authorize στην πύλη, η πύλη καθορίζει την ημερομηνία και την ώρα λήξης της έγκρισης βάσει της διαμορφωμένης περιόδου ισχύος της έγκρισης (χρησιμοποιώντας τύπο κάρτας, τράπεζα εμπόρου, συνδυασμό βεβαιότητας παραγγελίας). Όπου υποστηρίζεται για την τράπεζα εμπόρου, η λήξη έγκρισης επιστρέφεται στο πεδίο authorizationResponse.autoExpiry στην απόκριση πράξης Retrieve Transaction. Αυτό το πεδίο περιέχει την ημερομηνία και την ώρα που η πύλη θα λήξει αυτόματα την έγκριση.
Μόλις λήξει η περίοδος ισχύος της έγκρισης, η πύλη:
- θα επιχειρήσει αυτόματα να ακυρώσει την έγκριση και να αποδεσμεύσει τα χρήματα πίσω στον πληρωτή (όπου υποστηρίζεται για την τράπεζα εμπόρου). Για να επιτραπεί αυτό, θα πρέπει να έχετε ενεργοποιήσει το δικαίωμα "Αυτόματος αντιλογισμός ληγμένων εγκρίσεων" στο προφίλ εμπόρου από το your payment service provider.
Αν η παραγγελία έχει ήδη δεσμευθεί εν μέρει και αν η τράπεζα εμπόρου σας υποστηρίζει την ακύρωση των εγκρίσεων για μερικές δεσμεύσεις, η πύλη θα επιχειρήσει να ακυρώσει/αντιλογίσει το εκκρεμές ποσό έγκρισης.
- θα απορρίψει τα αιτήματα Capture για την παραγγελία
Ενημερώσεις έγκρισης
Η πύλη σάς επιτρέπει να παρατείνετε την περίοδο έγκρισης και προαιρετικά να αυξήσετε ή να μειώσετε το ποσό έγκρισης για έγκυρες εγκρίσεις, όπου υποστηρίζεται για την τράπεζα εμπόρου. Για να το κάνετε αυτό, πρέπει να έχετε ενεργοποιημένο το δικαίωμα Update Authorization στο προφίλ εμπόρου σας από τον your payment service provider. Για περισσότερες πληροφορίες, βλ. την Update Authorization.
Μεταχρονολογημένες εγκρίσεις
Η πύλη σάς επιτρέπει να μεταχρονολογήσετε μια έγκριση αν δεν μπορείτε να υποβάλετε μια συναλλαγή Authorize ή Pay τη στιγμή που ολοκληρώθηκε με τον πληρωτή. Η αποτυχία μπορεί να οφείλεται σε ζητήματα συνδεσιμότητας ή συστήματος ή άλλους περιορισμούς που απαιτούν να αναβάλετε την υποβολή έως ότου το σύστημα συνδεθεί ξανά online. Ο εντοπισμός των μεταχρονολογημένων εγκρίσεων είναι υποχρεωτικός για τη συμμόρφωση με τις απαιτήσεις του προγράμματος Visa.
Παρακάτω παρατίθενται ορισμένα σενάρια όπου πρέπει να υποδείξετε την έγκριση ως μεταχρονολογημένη για πληρωμές με κάρτα Visa:
- Αν είστε έμπορος που δέχεται πληρωμές με κάρτα σε τερματικό POS όπου το σύστημα έγκρισης POS είναι εκτός σύνδεσης, τότε η έγκριση που υποβάλλετε στη συνέχεια όταν το σύστημα είναι ξανά σε σύνδεση πρέπει να επισημανθεί ως μεταχρονολογημένη.
- Αν είστε έμπορος λιανικής που δέχεται πληρωμές μέσω τηλεφωνικών παραγγελιών όπου το σύστημα έγκρισης POS είναι εκτός σύνδεσης, τότε η έγκριση που υποβάλλετε στη συνέχεια όταν το σύστημα είναι ξανά σε σύνδεση πρέπει να επισημανθεί ως μεταχρονολογημένη.
Για μεταχρονολόγηση μιας έγκρισης, δώστε το πεδίο transaction.deferredAuthorization στο αίτημα Authorize, Pay ή Standalone Capture και ορίστε την τιμή σε TRUE. Αν δεν δώσετε αυτό το πεδίο, η προεπιλεγμένη τιμή θα οριστεί σε FALSE.
Για τους εμπόρους διαμετακόμισης, η έγκριση που υποβάλλετε για το συγκεντρωτικό ποσό στο τέλος της περιόδου μετακίνησης για όλες τις πληρωμές εντός μιας περιόδου μετακίνησης πρέπει να επισημαίνεται ως μεταχρονολογημένη. Για περισσότερες πληροφορίες, βλ. την ενότητα Συγκεντρωτικές πληρωμές ναύλων διαμετακόμιση.
Συχνές ερωτήσεις
Για να δεσμεύσετε περισσότερο από το εγκεκριμένο ποσό για μια παραγγελία, το προφίλ εμπόρου σας στην πύλη πρέπει να είναι ενεργοποιημένο για το δικαίωμα "Δέσμευση πιστωτικού υπολοίπου". Βλ. Δεσμεύσεις πιστωτικού υπολοίπου
Ναι, αυτό ονομάζεται αίτημα Standalone Capture και όπου υποστηρίζεται για την τράπεζα εμπόρου, μπορείτε να υποβάλετε απλώς ένα αίτημα Capture με τον κωδικό έγκρισης όπως επιστρέφεται από την τράπεζα εμπόρου σας (στην απόκριση έγκρισης).
Η πράξη Pay συνδυάζει αποτελεσματικά ένα αίτημα Authorize και ένα αίτημα Capture σε ένα μήνυμα. Μία συναλλαγή εγκρίνει την πληρωμή και μεταφέρει τα χρήματα από τον λογαριασμό του πληρωτή στον λογαριασμό σας.
Αν θέλετε να υποβάλετε μια πράξη Pay ως επακόλουθη πράξη, πρέπει να έχετε μια επιτυχή συναλλαγή επαλήθευσης και οι λεπτομέρειες της κάρτας στο αίτημα Pay και στη συναλλαγή Verify πρέπει να ταιριάζουν.
Το επίπεδο βεβαιότητας παραγγελίας για μια συναλλαγή Pay ορίζεται σε FINAL. Για περισσότερες πληροφορίες, βλ. τη Βεβαιότητα παραγγελίας.
Η συναλλαγή Pay είναι επίσης γνωστή ως "Sale", "Purchase".
Initiate Browser Payment. Για περισσότερες πληροφορίες, βλ. Υλοποίηση μιας ενοποίησης πληρωμής μέσω browser.Auto Capture
Η αυτόματη δέσμευση είναι μια παραλλαγή της πράξης Pay που επιτρέπει σε έναν έμπορο με δικαίωμα να εκτελεί μια συναλλαγή Pay και χρησιμοποιεί μια τράπεζα εμπόρου που υποστηρίζει μόνο συναλλαγές Authorize/Capture για να εκτελέσει μια συναλλαγή Authorize που ακολουθείται από μια αυτόματα προκαλούμενη συναλλαγή Capture. Με αυτόν τον τύπο συναλλαγής, το αίτημα Pay γίνεται πράξεις Authorize και Capture.
Αυτή η πράξη μπορεί να πραγματοποιηθεί με τη χρήση των μοντέλων ενοποίησης Direct Payment, Hosted Session ή Batch.
Το αναγνωριστικό συναλλαγής και για τα δύο αιτήματα Authorize και Capture θα είναι το αναγνωριστικό συναλλαγής που δώσατε στο αρχικό αίτημα Pay. Στην απόκριση Pay, το πεδίο transaction.type θα υποδείξει την τελευταία συναλλαγή που επιχειρήθηκε για την εκπλήρωση του αιτήματος, δηλαδή Authorize ή Capture.
Μπορείτε να χρησιμοποιήσετε την πράξη Retrieve για να ανακτήσετε τα αποτελέσματα μιας πράξης Auto-capture. Επιστρέφονται τα αποτελέσματα της τελευταίας συναλλαγής που επιχειρήθηκε για την εκπλήρωση του αιτήματος.
Μπορείτε να ακυρώσετε μια συναλλαγή Pay με αυτόματη δέσμευση χρησιμοποιώντας την πράξη Void Pay. Όταν εκτελείτε αυτή την πράξη, το Mastercard Gateway:
- επιχειρεί Void Capture για τη συναλλαγή Capture.
- Αν το Void Capture είναι επιτυχές, επιχειρείται μια πράξη Void Authorization για τη συναλλαγή Authorization. Αν το Void Capture δεν είναι επιτυχές, τότε η απόκριση υποδεικνύει ότι η ακύρωση απέτυχε και ότι δεν επιχειρήθηκε η πράξη Void Authorization.
Μεταχρονολογημένες εγκρίσεις
Μπορείτε να δώσετε έναν δείκτη στο αίτημα Pay για μεταχρονολόγηση της έγκρισης. Για περισσότερες πληροφορίες, βλ. την ενότητα Μεταχρονολογημένες εγκρίσεις.
Η πράξη Verify σάς επιτρέπει να επαληθεύσετε τις λεπτομέρειες λογαριασμού του πληρωτή πριν εκτελέσετε μια συναλλαγή Pay ή Authorize. Επαληθεύει τις λεπτομέρειες πληρωμής χρησιμοποιώντας τη μέθοδο επαλήθευσης που υποστηρίζεται από την τράπεζα εμπόρου. Για παράδειγμα, αν η τράπεζα εμπόρου υποστηρίζει υπηρεσία επαλήθευσης διεύθυνσης (AVS), τότε η πράξη Verify ότι αποστέλλει μια συναλλαγή AVS Only με ποσό συναλλαγής μηδέν και τις λεπτομέρειες διεύθυνσης του πληρωτή.
Μια συναλλαγή Standalone Capture είναι μια συναλλαγή Capture όπου η έγκριση έγινε εξωτερικά της πύλης. Κατά την υποβολή μιας Standalone Capture στην πύλη, πρέπει να δώσετε τον εξωτερικά δημιουργούμενο κωδικό έγκρισης στο πεδίο transaction.authorizationCode, και τα άλλα υποχρεωτικά πεδία.
Μπορείτε να υποβάλλετε συναλλαγές Standalone Capture αν έχετε το δικαίωμα "Δέσμευση" ενεργοποιημένο στο προφίλ εμπόρου σας.
Standalone Capture - Αναφορά API [REST][NVP]
Μεταχρονολογημένες εγκρίσεις
Μπορείτε να δώσετε έναν δείκτη στο αίτημα Standalone Capture για μεταχρονολόγηση της έγκρισης. Για περισσότερες πληροφορίες, βλ. την ενότητα Μεταχρονολογημένες εγκρίσεις.
Μια συναλλαγή Standalone Refund είναι μια συναλλαγή Refund που σας επιτρέπει να μεταφέρετε χρήματα από τον λογαριασμό σας πίσω στον πληρωτή χωρίς προηγούμενη αγορά. Οι συναλλαγές Standalone Refund μπορούν να γίνουν αν θέλετε να πιστώσετε τον λογαριασμό του πληρωτή χωρίς να συσχετίσετε την πίστωση σε μια προηγούμενη συναλλαγή.
Η πράξη Disbursement σάς επιτρέπει να στέλνετε χρήματα σε λογαριασμό κάρτας πληρωτή όταν απαιτείται, π.χ. για κέρδη τυχερών παιχνιδιών ή στοιχημάτων ή όταν πληρώνετε για λογαριασμό πιστωτικής κάρτας πληρωτή. Κατά την εκτέλεση μιας πράξης Disbursement, δεν απαιτούνται τα στοιχεία χρέωσης και αποστολής του πληρωτή και δεν ισχύει η επικύρωση του κωδικού ασφαλείας κάρτας (CSC). Η πράξη Disbursement μπορεί να πραγματοποιηθεί χωρίς προηγούμενες συναλλαγές ή μετά την επαλήθευση των λεπτομερειών λογαριασμού του πληρωτή.
Επακόλουθες πράξεις
Αυτή η ενότητα περιγράφει τις πράξεις που μπορούν να γίνουν για τις αρχικές συναλλαγές, Authorize ή Pay.
Για να ελέγξετε ποιες πράξεις έχουν διαμορφωθεί στο προφίλ εμπόρου σας, επικοινωνήστε με τον your payment service provider.
Η πράξη Update Authorization σάς επιτρέπει:
- Να παρατείνετε την περίοδο ισχύος μιας υπάρχουσας έγκρισης
- Να αυξήσετε ή να μειώσετε προαιρετικά το ποσό έγκρισης
Αν θέλετε μόνο να παρατείνετε την περίοδο έγκρισης, μην υποβάλετε transaction.amount στο αίτημα. Η ενημερωμένη ημερομηνία και ώρα λήξης της έγκρισης επιστρέφεται στο πεδίο authorizationResponse.autoExpiry στην απόκριση Retrieve Transaction. Συνιστάται να υποβάλετε το αίτημα Update Authorization εντός της περιόδου ισχύος της αρχικής έγκρισης.
Αν παρέχετε ένα ποσό συναλλαγής που είναι μεγαλύτερο από το ποσό της υπάρχουσας έγκρισης, το ποσό έγκρισης ενημερώνεται στο νέο ποσό. Για παράδειγμα, αν το υπάρχον ποσό έγκρισης είναι 100 δολάρια ΗΠΑ και δηλώσετε 120 δολάρια ΗΠΑ ως ποσό συναλλαγής στο αίτημα Update Authorization, τότε το νέο διαθέσιμο ποσό έγκρισης για δέσμευση θα είναι 120 δολάρια ΗΠΑ.
Αν παρέχετε ένα ποσό συναλλαγής που είναι μικρότερο από το ποσό της υπάρχουσας έγκρισης, το ποσό έγκρισης ενημερώνεται στο νέο ποσό. Για παράδειγμα, αν το υπάρχον ποσό έγκρισης είναι 100 δολάρια ΗΠΑ και δηλώσετε 80 δολάρια ΗΠΑ ως ποσό συναλλαγής στο αίτημα Update Authorization, τότε το νέο διαθέσιμο ποσό έγκρισης θα είναι 80 δολάρια ΗΠΑ. Η πύλη επεξεργάζεται αυτόματα ένα αίτημα αίτηση αντιλογισμού για το υπόλοιπο ποσό έγκρισης ύψους 20 USD (όπου υποστηρίζεται για την τράπεζα εμπόρου).
Σημειώστε ότι η πύλη μπορεί να ενημερώσει μια υπάρχουσα έγκριση μόνο αν πληρούνται οι ακόλουθες συνθήκες:
- Το προφίλ εμπόρου σας στην πύλη πρέπει να έχει ενεργοποιηθεί για το δικαίωμα "Ενημέρωση έγκρισης" από τον your payment service provider.
- Το νόμισμα παραγγελίας πρέπει να ταιριάζει με το νόμισμα στην υπάρχουσα έγκριση.
- Η υφιστάμενη έγκριση πρέπει να είναι έγκυρη, επιτυχής και πλήρως εγκεκριμένη.
Σύνολα παραγγελίας
Μετά από ένα επιτυχές αίτημα Update Authorization (για κάρτα ή PayPal), το ποσό της παραγγελίας (order.amount) και το συνολικό εγκεκριμένο ποσό (order.totalAuthorizedAmount) ενημερώνονται στο ποσό συναλλαγής (transaction.amount) για τη συναλλαγή Update Authorization. Αυτό ισχύει ανεξάρτητα από το αν η συναλλαγή Update Authorization υποβλήθηκε στην τράπεζα εμπόρου ή αν εγκρίθηκε αυτόματα από την πύλη (response.gatewayCode=APPROVED_AUTO). Ωστόσο, αν επιλέξετε να παρακάμψετε την ενημέρωση έγκρισης για ένα αίτημα δέσμευσης πιστωτικού υπολοίπου (υποβάλλοντας transaction.authorizationAdjustmentActions=NO_ACTION, βλ. Δεσμεύσεις πιστωτικού υπολοίπου) και η πύλη υποβάλλει μια δέσμευση πιστωτικού υπολοίπου στην τράπεζα εμπόρου, τα σύνολα της παραγγελίας ΔΕΝ ενημερώνονται.
response.gatewayCode=APPROVED_AUTO) ισχύει μόνο όταν το παρεχόμενο ποσό είναι μεγαλύτερο από το ποσό της υπάρχουσας έγκρισης. Μερικά σύνολα παραγγελίας
Μπορείτε να δώσετε τα παρακάτω ποσά μερικών συνόλων στο αίτημα Update Authorization για πληρωμές με κάρτα ή PayPal:
order.itemAmountorder.shippingAndHandlingAmountorder.taxAmountorder.discount.amount(πληρωμές με κάρτα μόνο)order.gratuityAmount(μόνο πληρωμές με κάρτα)
order.cashbackAmount στο αίτημα Update Authorization δεν υποστηρίζεται.Η πύλη ΔΕΝ επικυρώνει αν τα ποσά των μερικών συνόλων αθροίζονται στο transaction.amount(δηλαδή order.amount). Ωστόσο, πρέπει να το διασφαλίσετε για τις πληρωμές με PayPal.
Πρόσθετο τέλος
Μπορείτε ενημερώσετε ένα ποσό πρόσθετου τέλους στο αίτημα Update Authorization χρησιμοποιώντας κάποιο από τα παρακάτω πεδία:
order.surchargeAmount: Χρησιμοποιήστε αυτό το πεδίο αν δίνετε ένα εκ των προτέρων υπολογισμένο ποσό πρόσθετου τέλους.order.netAmount: Χρησιμοποιήστε αυτό το πεδίο αν η πύλη υπολογίζει το ποσό πρόσθετου τέλους (βάσει των κανόνων χρέωσης πρόσθετου τέλους).
order.surchargeAmount δεν υποστηρίζεται και τα αιτήματα με αυτό το πεδίο θα απορριφθούν. Αν δώσετε το order.netAmount σε μια πληρωμή με PayPal, η συναλλαγή θα διεκπεραιωθεί χωρίς να εφαρμοστεί πρόσθετο τέλος.Η πράξη Capture χρησιμοποιεί την έγκριση που λαμβάνεται από την αρχική πράξη Authorize για τη μεταφορά χρημάτων από τον λογαριασμό του πληρωτή στον λογαριασμό σας. Μια πράξη Capture πρέπει πάντα να προηγείται μιας επιτυχούς έγκρισης, και κατ' ελάχιστον το ID έγκρισης να αποστέλλεται με το αίτημα Capture. Το νόμισμα που χρησιμοποιείται για τη δέσμευση ενός ποσού πρέπει να ταιριάζει με το νόμισμα που χρησιμοποιείται στη συναλλαγή έγκρισης.
Οι δεσμεύσεις συγκεντρώνονται συνήθως σε πακέτο από την πύλη ή από το κεντρικό σύστημα της τράπεζας εμπόρου, έτσι τα χρήματα δεν μεταφέρονται στην πραγματικότητα μέχρι να κλείσει το πακέτο και να γίνει η τακτοποίηση.
Η πράξη Capture είναι επίσης γνωστή ως "Bill", "Complete".
Το συνολικό ποσό που δεσμεύετε μπορεί να υπερβεί το αρχικό εγκεκριμένο ποσό αν έχει ενεργοποιηθεί το προφίλ δέσμευσης πιστωτικού υπολοίπου στο προφίλ εμπόρου σας.
Η δέσμευση πιστωτικού υπολοίπου είναι μια παραλλαγή της δέσμευσης στο πλαίσιο της οποίας πραγματοποιείτε δεσμεύσεις για ποσά μεγαλύτερα από το εγκεκριμένο ποσό. Το επιτρεπόμενο πιστωτικό υπόλοιπο ορίζεται ως ποσοστό του αρχικού εγκεκριμένου ποσού και καθορίζεται από τον your payment service provider. Μπορείτε να εκτελέσετε μόνο μία δέσμευση πιστωτικού υπολοίπου ανά παραγγελία που έχει δεσμευτεί εν μέρει, εφόσον η δέσμευση φτάσει ή υπερβεί το αρχικό εγκεκριμένο ποσό.
Όταν υποβάλλετε ένα αίτημα Capture πιστωτικού υπολοίπου, η πύλη θα επιχειρήσει αυτόματα να ενημερώσει το ποσό έγκρισης στο ποσό που θέλετε να δεσμεύσετε. Αν η τράπεζα εμπόρου υποστηρίζει την ενημέρωση εγκρίσεων, η πύλη υποβάλλει το αίτημα Update Authorization στην τράπεζα εμπόρου. Σε αντίθετη περίπτωση, η πύλη θα εγκρίνει αυτόματα μια ενημέρωση έγκρισης (μέχρι το όριο δέσμευσης πιστωτικού υπολοίπου που έχει διαμορφωθεί προφίλ εμπόρου σας).
Υποβάλετε transaction.authorizationAjustmentAction=NO_ACTION στο αίτημα Capture, αν δεν θέλετε να επιχειρήσει η πύλη να ενημερώσει την έγκριση πριν την υποβολή του αιτήματος Capture στην τράπεζα εμπόρου. Σημειώστε ότι όταν η τιμή έγκρισης δεν αντιστοιχεί στη δέσμευση, η παραγγελία μπορεί να μην έχει προστασία με αντιστροφή της χρέωσης (chargeback).
Αν θέλετε να δεσμεύσετε εν μέρει μια έγκριση και για άλλες σχετικές πληροφορίες, βλ. Συχνές ερωτήσεις.
Η πράξη Refund σάς επιτρέπει να πιστώσετε κεφάλαια για μια υπάρχουσα παραγγελία πίσω στο λογαριασμό του πληρωτή. Οι επιστροφές χρημάτων μπορούν να πραγματοποιηθούν μόνο όταν μια μεταφορά χρημάτων έχει ολοκληρωθεί με μια συναλλαγή Pay ή Capture. Μπορείτε να εκτελέσετε οποιονδήποτε αριθμό συναλλαγών επιστροφής χρημάτων για την αρχική συναλλαγή, αλλά δεν μπορείτε να επιστρέψετε περισσότερα από το σύνολο που έχει αποκτηθεί μέσω όλων των συναλλαγών αγοράς ή δέσμευσης που συσχετίζονται με την παραγγελία.
Οι επιστροφές χρημάτων γίνονται για πολλούς λόγους, π.χ. επιστροφή ανεπιθύμητων, λάθος ή ελαττωματικών προϊόντων
Έγκριση επιστροφής χρημάτων
Πριν από την υποβολή του αιτήματος επιστροφής χρημάτων στην τράπεζα εμπόρου για συμψηφισμό και τακτοποίηση (settlement), από προεπιλογή, η πύλη προσπαθεί αυτόματα να εγκρίνει την επιστροφή χρημάτων σας με τον εκδότη (όπου υποστηρίζεται από την τράπεζα εμπόρου). Αυτό επιτρέπει στους εκδότες να επαληθεύουν τις λεπτομέρειες κάρτας που παρέχονται στο αίτημα επιστροφής χρημάτων για να διασφαλιστεί ότι η επιστροφή χρημάτων θα είναι επιτυχής.
Η έγκριση της επιστροφής χρημάτων εκτελείται online και επιστρέφει απόκριση σε πραγματικό χρόνο (real time). Αυτό έχει πολλά οφέλη:
- Λαμβάνετε άμεση ειδοποίηση από τους εκδότες της κάρτας αν η επιστροφή χρημάτων είναι επιτυχής ή όχι. Αυτό σας επιτρέπει να κάνετε τις κατάλληλες ενέργειες όταν ο εκδότης αποκρίνεται με απόρριψη. Για παράδειγμα, αν η κάρτα που χρησιμοποιείται για συναλλαγή επιστροφής χρημάτων δεν είναι πλέον έγκυρη, ο εκδότης απορρίπτει την έγκριση της επιστροφής χρημάτων. Μπορείτε να επικοινωνήσετε με τον πληρωτή για να κανονίσετε την επιστροφή χρημάτων μέσω διαφορετικού μέσου πληρωμής.
- Ο εκδότης της κάρτας λαμβάνει άμεση ειδοποίηση για το αίτημα επιστροφής χρημάτων, το οποίο επιτρέπει στους εκδότες να εμφανίζουν άμεσα πληροφορίες σχετικά με την επιστροφή χρημάτων στον πληρωτή. Τους επιτρέπει επίσης να διαχειρίζονται αποτελεσματικά τα ερωτήματα/παράπονα των πληρωτών.
Αν δεν θέλετε η πύλη να υποβάλλει αιτήματα έγκρισης για επιστροφές χρημάτων, θα πρέπει να έχετε το δικαίωμα "Ενεργοποίηση επιστροφών χρημάτων χωρίς εγκρίσεις". Ακόμη και αν έχετε αυτό το δικαίωμα, μπορείτε να ζητήσετε έγκριση για επιστροφές χρημάτων ορίζοντας το πεδίο action.refundAuthorization = true στο αίτημα Refund API.
Αν η έγκριση επιστροφής χρημάτων είναι επιτυχής, ο διακομιστής πληρωμών (payment server) προχωρά με την επιστροφή χρημάτων, διαφορετικά η επιστροφή χρημάτων απορρίπτεται. Το αποτέλεσμα της συναλλαγής επιστροφής χρημάτων επιστρέφεται στην απόκριση συναλλαγής. Ο κωδικός έγκρισης που ελήφθη από τον εκδότη θα εμφανιστεί στο Merchant Administration.
Επιστροφή χρημάτων για συγκεκριμένη δέσμευση
Πρέπει να επιλέξετε τη στοχευμένη δέσμευση στην ενότητα "Επιστροφή χρημάτων" και, στη συνέχεια, να εισαγάγετε το ποσό επιστροφής χρημάτων. Αν υπάρχουν πολλές δεσμεύσεις, τότε θα εμφανιστεί το νέο περιβάλλον εργασίας χρήστη, διαφορετικά αν υπάρχει μία δέσμευση, θα εμφανιστεί το υπάρχον περιβάλλον εργασίας χρήστη. Κατά τη μετάβαση με το API, το transaction.targetTransactionld είναι υποχρεωτικό μόνο όταν υπάρχουν πολλές δεσμεύσεις.
Το συνολικό ποσό που επιστρέφεται για μια παραγγελία μπορεί να υπερβαίνει το ποσό που έχει δεσμευτεί με επιτυχία για μια παραγγελία αν έχει ενεργοποιηθεί το δικαίωμα επιστροφής του επιπλέον πιστωτικού υπολοίπου στο προφίλ εμπόρου σας.
Το πιστωτικό υπόλοιπο που επιτρέπεται πάνω από το δεσμευμένο ποσό για συναλλαγές DirectAPI μπορεί να διαμορφωθεί ανά βάση νομίσματος στις ρυθμίσεις ενοποίησης του Merchant Administration. Αν δεν ορίσετε ένα όριο επιστροφής πιστωτικού υπολοίπου για ένα νόμισμα, οι επιστροφές πιστωτικού υπολοίπου απορρίπτονται για παραγγελίες σε αυτό το νόμισμα.
Όταν υποβάλλετε μια επιστροφή χρημάτων, το συνολικό ποσό που επιστρέφεται για την παραγγελία (συμπεριλαμβανομένης της επιχειρούμενης επιστροφής) δεν πρέπει να υπερβαίνει το συνολικό ποσό που έχει δεσμευτεί για αυτήν την παραγγελία πάνω από το μέγιστο πιστωτικό υπόλοιπο που επιτρέπεται. Για παράδειγμα, αν υποβάλλετε μια επιστροφή πιστωτικού υπολοίπου μέσω του DirectAPI για μια παραγγελία της οποίας το συνολικό δεσμευμένο ποσό είναι $100 USD και έχετε ορίσει το όριο για την επιστροφή πιστωτικού υπολοίπου για συναλλαγές DirectAPI σε $20 USD, τότε μπορείτε να επιστρέψετε έως $120 USD.
Η πράξη Disbursement σάς επιτρέπει να στέλνετε χρήματα σε λογαριασμό κάρτας πληρωτή όταν απαιτείται, π.χ. για κέρδη τυχερών παιχνιδιών ή στοιχημάτων ή όταν πληρώνετε για λογαριασμό πιστωτικής κάρτας πληρωτή. Κατά την εκτέλεση μιας πράξης Disbursement, δεν απαιτούνται τα στοιχεία χρέωσης και αποστολής του πληρωτή και δεν ισχύει η επικύρωση του κωδικού ασφαλείας κάρτας (CSC). Η πράξη Disbursement μπορεί να πραγματοποιηθεί χωρίς προηγούμενες συναλλαγές ή μετά την επαλήθευση των λεπτομερειών λογαριασμού του πληρωτή.
Η πράξη Retrieve Transaction σάς επιτρέπει να ανακτήσετε τις λεπτομέρειες για μια συναλλαγή χρησιμοποιώντας το ID παραγγελίας και το ID συναλλαγής. Και τα δύο χρειάζονται, καθώς το ID συναλλαγής προσδιορίζει μια συναλλαγή εντός μιας παραγγελίας.
Η πράξη Retrieve Order σάς επιτρέπει να ανακτήσετε τις λεπτομέρειες για μια παραγγελία και όλες τις συναλλαγές που συσχετίζονται με τη συγκεκριμένη παραγγελία.
Η πράξη Void επιχειρεί να διαγράψει/αντιλογίσει αμέσως ένα αίτημα συναλλαγής. Οι ακυρώσεις μπορούν να πραγματοποιηθούν μόνο για συναλλαγές που δεν έχουν ακόμη σταλεί στην τράπεζα από την τράπεζα εμπόρου για διεκπεραίωση στο τέλος της ημέρας. Μόλις η συναλλαγή σταλεί από την τράπεζα εμπόρου για διεκπεραίωση, πρέπει να εκτελέσετε μια πράξη Refund αντί για μια πράξη Void.
Μπορείτε να ακυρώσετε τις συναλλαγές Authorize, Capture, Pay ή Refund. Μια ακύρωση που εκτελείται για μια συναλλαγή Authorize θα αποδεσμεύσει αμέσως όλα τα δεσμευμένα χρήματα. Σε όλους τους άλλους τύπους συναλλαγών, η ακύρωση θα αποτρέψει τη μεταφορά χρημάτων.
Η πράξη Referral υποβάλλει εκ νέου μια αναφερόμενη αρχική συναλλαγή (συναλλαγή Authorization ή Pay που έλαβε απόκριση από την τράπεζα εμπόρου "Παραπομπή στον εκδότη") ως νέα συναλλαγή Authorization ή Pay με έναν κωδικό έγκρισης που λαμβάνετε από τον εκδότη.
Από τον πληρωτή ενδέχεται να ζητηθεί να δώσει πρόσθετες πληροφορίες προκειμένου ο εκδότης να εγκρίνει τη συναλλαγή και να παράσχει έναν κωδικό έγκρισης/ID μη αυτόματης έγκρισης.
Η αντιστροφή χρεώσεων (chargeback) συμβαίνει όταν ένας πληρωτής αμφισβητεί μια πληρωμή που σας έγινε. Για παράδειγμα, τα προϊόντα δεν παραλήφθηκαν ή ο πληρωτής δεν ενέκρινε την πληρωμή σε εσάς. Ο Your payment service provider μπορεί να επιλέξει να εισάγει λεπτομέρειες των συναλλαγών αντιστροφής χρέωσης (chargeback) στην πύλη, έτσι ώστε να σας είναι διαθέσιμες για σκοπούς αναζήτησης και αναφοράς. Ο Your payment service provider μπορεί να επιλέξει να καταγράψει κάθε συναλλαγή αντιστροφής χρέωσης (chargeback) έναντι της αρχικής παραγγελίας ή να δημιουργήσει μια νέα παραγγελία με μια αυτόνομη συναλλαγή αντιστροφής χρέωσης (chargeback).
Η πύλη μπορεί να δημιουργήσει πολλαπλές συναλλαγές αντιστροφής χρέωσης (chargeback) για μία μόνο παραγγελία. Μπορείτε να εκτελέσετε επακόλουθες συναλλαγές για μια παραγγελία που περιέχει μια συναλλαγή αντιστροφής χρέωσης (chargeback), για παράδειγμα ακυρώσεις ή επιστροφές χρημάτων.
Μια επιτυχώς καταγεγραμμένη συναλλαγή αντιστροφής χρέωσης (chargeback) θα επιστρέψει τα ακόλουθα πεδία στην απόκριση Retrieve Transaction/Retrieve Order:
order.status=CHARGEBACK_PROCESSEDήDISPUTED: Όταν δημιουργείται μια συναλλαγή αντιστροφής χρέωσης (chargeback), η κατάσταση της αντίστοιχης παραγγελίας ενημερώνεται για να δηλώσει ότι έχει υπάρξει διαφορά που εγείρει ο πληρωτής.- Το
order.status=DISPUTEDυποδεικνύει ότι έχει ανακύψει διαφορά, αλλά δεν έχουν κινηθεί ακόμη χρήματα. - Το
order.status=CHARGEBACK_PROCESSEDδηλώνει ότι έχει διεκπεραιωθεί μια αξίωση αντιστροφής χρέωσης (chargeback) και ότι τα χρήματα θα μεταφερθούν από ή προς τον λογαριασμό εμπόρου.
- Το
order.chargeback.amountorder.chargeback.currency- Ομάδα παραμέτρων
transaction.dispute: Πληροφορίες σχετικά με τη διαφορά αντιστροφής χρέωσης (chargeback), για παράδειγμα συμβάν διαφοράς, ημερομηνία, κ.λπ. transaction.type=CHARGEBACKtransaction.source=SERVICE_PROVIDERgatewayEntryPoint=SERVICE_PROVIDER_API