Συναλλαγές
Οι συναλλαγές είναι ενέργειες που γίνονται στην παραγγελία. Μπορεί να επαληθεύουν την ταυτότητα του πληρωτή ή της κάρτας, να δεσμεύουν τα κεφάλαια του πληρωτή ή να μετακινούν χρήματα μεταξύ εσάς και του πληρωτή. Ξεκινάτε μια συναλλαγή στο σύστημά σας στέλνοντας ένα αίτημα API στο Mastercard Gateway, το οποίο με τη σειρά του επεξεργάζεται το αίτημα και το στέλνει σε έναν σχετικό πάροχο τρόπου πληρωμής ή σε μια σχετική τράπεζα εμπόρου. Για να εκτελέσετε οποιαδήποτε πράξη API, όπως η εκκίνηση μιας συναλλαγής, πρέπει να έχετε ορίσει το απαιτούμενο δικαίωμα στο προφίλ εμπόρου σας για την πύλη. Για να ελέγξετε ποιες συναλλαγές μπορείτε να εκκινήσετε, επικοινωνήστε με τον your payment service provider. Οι πληρωμές χωρίς κάρτα ή τα χρεωστικά δίκτυα ενδέχεται να έχουν περιορισμένο σύνολο πράξεων API σε σύγκριση με πιστωτικές κάρτες.
Οι ακόλουθες ενότητες περιγράφουν τις περιπτώσεις χρήσης για μεμονωμένες συναλλαγές με κάρτα. Περιλαμβάνουν απλά παραδείγματα αιτημάτων με τα υποχρεωτικά πεδία μόνο, χρησιμοποιώντας έναν τρόπο πληρωμής με πιστωτική κάρτα με αποθηκευμένες λεπτομέρειες πιστωτικής κάρτας που δίνονται ως token. Για περισσότερα παραδείγματα αιτημάτων και αποκρίσεων, βλ. τη συλλογή Postman.
Αρχικές, αυτόνομες και επακόλουθες συναλλαγές
Οι συναλλαγές που υποστηρίζονται στο Mastercard Gateway μπορούν να χωριστούν σε τέσσερις ομάδες, ανάλογα με το πώς μπορούν να χρησιμοποιηθούν:
- Αρχικές
Οι αρχικές συναλλαγές δημιουργούν μια νέα παραγγελία και ξεκινούν τη ροή πληρωμών για την περίπτωση πώλησης. Αυτές οι συναλλαγές χρειάζονται ένα μοναδικό αναγνωριστικό παραγγελίας που καθορίζει τη νέα παραγγελία. Οι ακόλουθοι τύποι συναλλαγών μπορούν να χρησιμοποιηθούν ως αρχικές συναλλαγές:
- Αυτόνομες
Οι αυτόνομες συναλλαγές είναι ένας ειδικός τύπος αρχικής συναλλαγής, που χρησιμοποιείται σε περιπτώσεις όπου η αρχική συναλλαγή για μια παραγγελία εκτελείται εκτός της πύλης ή απλά δεν θέλετε να συσχετίσετε τη συναλλαγή με μια υπάρχουσα παραγγελία. Αυτές οι συναλλαγές είναι επίσης γνωστές στον κλάδο ως: συναλλαγές που δεν αναφέρονται, δεν αντιστοιχίζονται ή δεν είναι συνδεδεμένες και δεν είναι ενεργοποιημένες από προεπιλογή λόγω κινδύνου απάτης.
Οι ακόλουθοι τύποι συναλλαγών μπορούν να χρησιμοποιηθούν ως αυτόνομες συναλλαγές:
- Επακόλουθες
Οι επακόλουθες συναλλαγές σχετίζονται με μια υπάρχουσα παραγγελία, καθώς τροποποιούν ή προχωρούν αυτήν την παραγγελία με κάποιο τρόπο. Αυτές οι συναλλαγές πρέπει να συνδέονται με μια αρχική συναλλαγή χρησιμοποιώντας το αναγνωριστικό παραγγελίας της.
Οι ακόλουθοι τύποι συναλλαγών μπορούν να χρησιμοποιηθούν ως επακόλουθες συναλλαγές:
- Ενημερωτικές
Οι ενημερωτικές συναλλαγές δημιουργούνται από τον διεκπεραιωτή πληρωμών ή την τράπεζα εμπόρου για την παροχή πρόσθετων πληροφοριών σχετικά με την παραγγελία.
Για περισσότερες πληροφορίες σχετικά με την πράξη Authorize, βλ Authorize.
Authorize
Η συναλλαγή AUTHORIZE επαληθεύει τις λεπτομέρειες κάρτας του πληρωτή σας, ελέγχει ότι ο πληρωτής σας διαθέτει επαρκή χρήματα στην πιστωτική γραμμή του και επιχειρεί να κρατήσει τα απαιτούμενα χρήματα. Το πιστωτικό όριο του πληρωτή μειώνεται κατά το εγκεκριμένο ποσό και τα χρήματα κρατούνται για μια χρονική περίοδο (στις περισσότερες περιπτώσεις 5-8 ημέρες), όπως καθορίζεται από το πρόγραμμα καρτών και τους κανόνες έκδοσης της κάρτας του πληρωτή. Για μια επιτυχημένη έγκριση, η πύλη επιστρέφει το αποτέλεσμα=SUCCESS στην απόκριση συναλλαγής.
Η έγκριση δεν χρεώνει χρήματα από τον λογαριασμό του πληρωτή σας, αλλά κρατεί το συνολικό ποσό της παραγγελίας, έτοιμο για να χρεώσει η συναλλαγή CAPTURE την κάρτα και να μεταφέρει τα χρήματα στον λογαριασμό σας. Οι συναλλαγές AUTHORIZE δεν εμφανίζονται στην κατάσταση λογαριασμού του πληρωτή, σε αντίθεση με τις συναλλαγές CAPTURE.
Πολλά συστήματα ηλεκτρονικής τραπεζικής παρέχουν πλέον ειδοποίηση για τη δραστηριότητα έγκρισης.
Μια συναλλαγή AUTHORIZE μπορεί να είναι μια αρχική συναλλαγή (χωρίς προηγούμενες σχετικές συναλλαγές) ή μια επακόλουθη συναλλαγή μετά από VERIFY ή AUTHENTICATE_PAYER. Στην τελευταία περίπτωση, οι λεπτομέρειες της κάρτας στα αιτήματα VERIFY ή AUTHENTICATE_PAYER πρέπει να αντιστοιχούν στο AUTHORIZE.
Αν πρέπει να δεσμεύσετε ένα ποσό μεγαλύτερο από αυτό που έχετε εγκρίνει ή, αν πρέπει να δεσμεύσετε μια έγκριση που έχετε εκτελέσει εκτός της πύλης, βλ. Χρήση επιπλέον πιστωτικών δεσμεύσεων και Standalone Capture, αντίστοιχα.
| Διεύθυνση URL | https://ibanke-commerce.nbg.gr/api/rest/version/72/merchant/<merchant_ID>/order/<order_ID>/transaction/<transaction_ID> |
| Μέθοδος HTTP | PUT |
{
"apiOperation": "AUTHORIZE",
"order": {
"amount": "100.00",
"currency": "EUR"
},
"sourceOfFunds": {
"token": "<token>"
}
}
Ρύθμιση βεβαιότητας παραγγελίας
Μπορείτε να υποδείξετε ένα επίπεδο βεβαιότητας σχετικά με το ποσό έγκρισης που θα δεσμευθεί με την παροχή του πεδίου order.certainty στο αίτημα AUTHORIZE. Για να το κάνετε αυτό, πρέπει να έχετε ενεργοποιημένο το δικαίωμα αλλαγής βεβαιότητας παραγγελίας στο προφίλ εμπόρου σας από τον your payment service provider. Μπορείτε να ορίσετε το πεδίο σε κάποια από τις ακόλουθες τιμές:
- Τελικό
Το πλήρες εγκεκριμένο ποσό αναμένεται να δεσμευτεί με μία ή περισσότερες δεσμεύσεις εντός της καθορισμένης προθεσμίας (συνήθως 7 ημέρες). Η παραγγελία θα ακυρωθεί μόνο σε εξαιρετικές περιπτώσεις (για παράδειγμα, ο πληρωτής ακύρωσε την αγορά του). Αν δοθεί αυτή η τιμή για τη συναλλαγή σας, μπορεί να δικαιούται χαμηλότερα τέλη διεκπεραίωσης.
- Εκτιμώμενο
Το εγκεκριμένο ποσό είναι μια εκτίμηση του ποσού που θα δεσμευτεί εντός της καθορισμένης προθεσμίας (συνήθως 30-31 ημέρες). Είναι πιθανό το ποσό που έχει δεσμευθεί να είναι λιγότερο ή να μην έχει δεσμευθεί καθόλου, ή η έγκριση μπορεί να έχει ακυρωθεί. Η παροχή αυτής της τιμής στη συναλλαγή σας μπορεί να σας κοστίσει υψηλότερα τέλη διεκπεραίωσης.
Το αίτημα απορρίπτεται αν δεν έχετε το δικαίωμα να αλλάξετε τη βεβαιότητα παραγγελίας και η τιμή που δίνετε σε αυτό το πεδίο δεν ταιριάζει με την προεπιλεγμένη τιμή βεβαιότητας παραγγελίας που έχει διαμορφωθεί στο προφίλ εμπόρου σας.
Αντιλογισμός εγκρίσεων
Η πύλη μπορεί να αντιλογίσει τα εκκρεμή ποσά έγκρισης για μη δεσμευμένες, εν μέρει δεσμευμένες ή ληγμένες εγκρίσεις, όπου υποστηρίζονται για την τράπεζα εμπόρου. Αυτό σας επιτρέπει να συμμορφώνεστε με τις απαιτήσεις του προγράμματος κάρτας για πλήρεις και μερικούς αντιλογισμούς.
- Μη δεσμευμένες εγκρίσεις
Αν δεν θέλετε να δεσμεύσετε το εγκεκριμένο ποσό μετά την υποβολή ενός αιτήματος AUTHORIZE, πρέπει να ακυρώσετε την έγκριση υποβάλλοντας ένα αίτημα VOID. Δώστε το ID συναλλαγής για την έγκριση που θα ακυρωθεί στο πεδίο
transaction.targetTransactionId. - Εν μέρει δεσμευμένες εγκρίσεις
Κατά την υποβολή ενός αιτήματος CAPTURE για μια παραγγελία, μπορείτε να παρέχετε ένα ποσό CAPTURE χαμηλότερο από το εγκεκριμένο ποσό για το
(order.AuthorizedAmount)παραγγελίας που ορίζεται στο αίτημά σας AUTHORIZE. Αν δεν σκοπεύετε να δεσμεύσετε το υπόλοιπο εγκεκριμένο ποσό, μπορείτε να ακυρώσετε το υπόλοιπο εγκεκριμένο ποσό, εφόσον υποστηρίζεται για την τράπεζα εμπόρου. - Υποβάλετε ένα αίτημα VOID με το ID συναλλαγής για τη συναλλγή AUTHORIZE που θα ακυρωθεί στο πεδίο
transaction.targetTransactionId. - Δώστε τον αναμενόμενο αριθμό CAPTURES για την παραγγελία στο πεδίο
order.expectedNumberOfCapturesστο αίτημα CAPTURE ή μέσω του Merchant Administration. Σε περίπτωση που ο συνολικός αριθμός των CAPTURES για την παραγγελία (συμπεριλαμβανομένης της τρέχουσας CAPTURE) υπερβαίνει ή ισούται με τον συνολικό αναμενόμενο αριθμό αιτημάτων CAPTURE, η πύλη θα προκαλέσει αυτόματα ένα αίτημα VOID του υπόλοιπου εγκεκριμένου ποσού, όπου υποστηρίζεται για την τράπεζα εμπόρου. Για να επιτραπεί η αυτόματη ενεργοποίηση, πρέπει να έχετε ενεργοποιημένο το δικαίωμα "Αυτόματος αντιλογισμός εκκρεμών ποσών έγκρισης" στο προφίλ εμπόρου σας από τον your payment service provider. - Ληγμένες εγκρίσεις
- Θα επιχειρήσει αυτόματα να ακυρώσει την έγκριση και να αποδεσμεύσει τα χρήματα πίσω στον πληρωτή (όπου υποστηρίζεται για την τράπεζα εμπόρου). Για να επιτραπεί αυτό, θα πρέπει να έχετε ενεργοποιήσει το δικαίωμα Αυτόματος αντιλογισμός ληγμένων εγκρίσεων στο προφίλ εμπόρου από τον your payment service provider.
Αν η παραγγελία έχει δεσμευθεί εν μέρει και αν η τράπεζα εμπόρου σας υποστηρίζει την ακύρωση των εγκρίσεων για μερικές δεσμεύσεις, η πύλη θα επιχειρήσει να ακυρώσει/αντιλογίσει το εκκρεμές ποσό έγκρισης.
- Απορρίπτει τυχόν αιτήματα Capture έναντι της παραγγελίας
- Ενημέρωση εγκρίσεων
- Μεταχρονολόγηση εγκρίσεων
- Αν είστε έμπορος που δέχεται πληρωμές με κάρτα σε τερματικό POS όπου το σύστημα έγκρισης POS είναι εκτός σύνδεσης.
- Αν είστε έμπορος λιανικής που δέχεται πληρωμές μέσω τηλεφωνικών παραγγελιών όπου το σύστημα έγκρισης POS είναι εκτός σύνδεσης.
Μπορείτε να επιχειρήσετε να ακυρώσετε (αντιλογήσετε) το οφειλόμενο ποσό έγκρισης με δύο τρόπους:
Για παράδειγμα, αν δώσετε order.expectedNumberOfCaptures = 2 στο πρώτο αίτημα CAPTURE, η πύλη αντιλογίζει αυτόματα το υπόλοιπο εγκεκριμένο ποσό κατά τη διεκπεραίωση του δεύτερου αιτήματος CAPTURE.
Αν μειώσετε τον αναμενόμενο αριθμό δεσμεύσεων στα επόμενα αιτήματα CAPTURE (για παράδειγμα, ενημέρωση order.expectedNumberOfCaptures = 1 στο δεύτερο αίτημα CAPTURE), η πύλη αντιλογίζει αυτόματα το υπόλοιπο εγκεκριμένο ποσό κατά τη διεκπεραίωση του δεύτερου αιτήματος CAPTURE. Αυτό συμβαίνει επειδή το 2 (ο συνολικός αριθμός CAPTURES για την παραγγελία, συμπεριλαμβανομένης της τρέχουσας CAPTURE) υπερβαίνει το 1 (τον αναμενόμενο αριθμό CAPTURES). Ωστόσο, αν αυξήσετε τον αναμενόμενο αριθμό CAPTURES στα επόμενα αιτήματα CAPTURE (για παράδειγμα, ενημέρωση order.expectedNumberOfCaptures = 3 στο δεύτερο αίτημα CAPTURE), η πύλη δεν θα αντιλογίσει το υπόλοιπο ποσό μέχρι να λάβει το τρίτο αίτημα CAPTURE.
Οι εγκρίσεις έχουν περίοδο ισχύος μετά την οποία λήγουν. Η περίοδος ισχύος της έγκρισης μπορεί να διαμορφωθεί στην πύλη για μια τράπεζα εμπόρου, έναν τύπο κάρτας και έναν συνδυασμό βεβαιότητας παραγγελίας.
Όταν υποβάλλετε ένα αίτημα Authorize στην πύλη, η πύλη καθορίζει την ημερομηνία και την ώρα λήξης της έγκρισης βάσει της διαμορφωμένης περιόδου ισχύος της έγκρισης (χρησιμοποιώντας τύπο κάρτας, τράπεζα εμπόρου, συνδυασμό βεβαιότητας παραγγελίας). Όπου υποστηρίζεται για την τράπεζα εμπόρου, η λήξη έγκρισης επιστρέφεται στο πεδίο authorizationResponse.autoExpiry στην απόκριση πράξης Retrieve Transaction. Αυτό το πεδίο περιέχει την ημερομηνία και την ώρα που η πύλη θα λήξει αυτόματα την έγκριση.
Μόλις λήξει η περίοδος ισχύος της έγκρισης, η πύλη:
Η πύλη σάς επιτρέπει να παρατείνετε την περίοδο έγκρισης και προαιρετικά να αυξήσετε ή να μειώσετε το ποσό έγκρισης για έγκυρες εγκρίσεις, εφόσον υποστηρίζεται για την τράπεζα εμπόρου. Για να το κάνετε αυτό, πρέπει να έχετε ενεργοποιημένο το δικαίωμα Update Authorization στο προφίλ εμπόρου σας από τον your payment service provider. Για περισσότερες πληροφορίες, βλ. την Update Authorization.
Μπορείτε να μεταχρονολογήσετε μια έγκριση αν δεν μπορείτε να υποβάλετε μια συναλλαγή AUTHORIZE ή PAY τη στιγμή που ολοκληρώθηκε με τον πληρωτή. Η αποτυχία μπορεί να οφείλεται σε ζητήματα συνδεσιμότητας ή συστήματος ή άλλους περιορισμούς που απαιτούν να υποβάλετε την έγκριση αργότερα όταν το σύστημα είναι ξανά online. Ο εντοπισμός των μεταχρονολογημένων εγκρίσεων είναι υποχρεωτικός για τη συμμόρφωση με τις απαιτήσεις του προγράμματος Visa.
Παρακάτω παρατίθενται ορισμένα σενάρια όπου πρέπει να υποδείξετε την έγκριση ως μεταχρονολογημένη για πληρωμές με κάρτα Visa:
Για μεταχρονολόγηση μιας έγκρισης, δώστε το πεδίο transaction.deferredAuthorization στο αίτημα AUTHORIZE, PAY ή STANDALONE CAPTURE και ορίστε την τιμή του σε TRUE. Αν δεν δώσετε αυτό το πεδίο, η προεπιλεγμένη τιμή είναι FALSE.
Capture
Η συναλλαγή Capture (γνωστή και ως "τιμολόγηση" ή "ολοκλήρωση") χρησιμοποιεί την έγκριση που αποκτήθηκε μετά την αρχική πράξη AUTHORIZE για τη μεταφορά χρημάτων από τον λογαριασμό του πληρωτή στον λογαριασμό σας. Μια συναλλαγή CAPTURE πρέπει πάντα να προηγείται από μια επιτυχημένη έγκριση. Το νόμισμα που χρησιμοποιείται για τη δέσμευση ενός ποσού πρέπει να ταιριάζει με το νόμισμα που χρησιμοποιείται στη συναλλαγή έγκρισης.
Οι δεσμεύσεις συγκεντρώνονται συνήθως σε πακέτο από την πύλη ή από το κεντρικό σύστημα της τράπεζας εμπόρου, έτσι τα χρήματα δεν μεταφέρονται στην πραγματικότητα μέχρι να κλείσει το πακέτο και να γίνει η τακτοποίηση.
| Διεύθυνση URL | https://ibanke-commerce.nbg.gr/api/rest/version/72/merchant/<merchant_ID>/order/<order_ID>/transaction/<transaction_ID> |
| Μέθοδος HTTP | PUT |
{
"apiOperation": "CAPTURE",
"transaction": {
"amount": "100.00",
"currency": "EUR"
}
}
Για να δεσμεύσετε μια έγκριση που εκτελείται εκτός της πύλης, βλ. Standalone Capture.
Χρήση δεσμεύσεων πιστωτικού υπολοίπου
Το συνολικό ποσό που δεσμεύεται μπορεί να υπερβαίνει το αρχικό εγκεκριμένο ποσό αν το δικαίωμα εκτέλεσης δέσμευσης πιστωτικού υπολοίπου είναι ενεργοποιημένο στο προφίλ εμπόρου σας.
Η δέσμευση πιστωτικού υπολοίπου είναι μια παραλλαγή της συναλλαγής CAPTURE όπου εκτελείτε μια δέσμευση για ποσό μεγαλύτερο από το εγκεκριμένο ποσό. Το επιτρεπόμενο πιστωτικό υπόλοιπο προσδιορίζεται ως ποσοστό του αρχικού εγκεκριμένου ποσού και καθορίζεται από τον your payment service provider.
Όταν υποβάλλετε ένα αίτημα CAPTURE πιστωτικού υπολοίπου, η πύλη επιχειρεί αυτόματα να ενημερώσει το ποσό έγκρισης στο ποσό που θέλετε να δεσμεύσετε. Αν η τράπεζα εμπόρου υποστηρίζει την ενημέρωση εγκρίσεων, η πύλη υποβάλλει το αίτημα UPDATE AUTHORIZATION στην τράπεζα εμπόρου. Αν όχι, η πύλη εγκρίνει αυτόματα μια ενημέρωση έγκρισης (μέχρι το όριο δέσμευσης πιστωτικού υπολοίπου που έχει διαμορφωθεί για το προφίλ εμπόρου σας).
Αν δεν θέλετε η πύλη να επιχειρήσει να ενημερώσει την έγκριση πριν από την υποβολή της δέσμευσης στην τράπεζα εμπόρου, ορίστε το πεδίο transaction.authorizationAjustmentAction σε NO_ACTION στο αίτημα.
Chargeback
Μια συναλλαγή αντιστροφής χρέωσης (chargeback) πραγματοποιείται όταν ένας πληρωτής αμφισβητεί μια πληρωμή που σας έγινε. Για παράδειγμα, τα προϊόντα δεν παραλήφθηκαν ή ο πληρωτής δεν ενέκρινε την πληρωμή σε εσάς. Ο Your payment service provider μπορεί να εισάγει λεπτομέρειες των συναλλαγών αντιστροφής χρέωσης (chargeback) στην πύλη, έτσι ώστε να σας είναι διαθέσιμες για σκοπούς αναζήτησης και αναφοράς. Ο Your payment service provider μπορεί να επιλέξει να καταγράψει κάθε συναλλαγή αντιστροφής χρέωσης (chargeback) έναντι της αρχικής παραγγελίας ή να δημιουργήσει μια νέα παραγγελία με μια αυτόνομη συναλλαγή αντιστροφής χρέωσης (chargeback).
- Αν μοιράζεστε τον αριθμό SE ή το αναγνωριστικό εμπόρου της τράπεζας (το αναγνωριστικό που σας έχει εκχωρηθεί από την αποδέκτρια τράπεζα) σε πολλά προφίλ εμπόρων, δημιουργείται μια αυτόνομη συναλλαγή αντιστροφής χρέωσης (chargeback) για κάθε προφίλ.
- Η πύλη καταγράφει τις συναλλαγές αντιστροφής χρέωσης (chargeback) μόνο για ενημερωτικούς σκοπούς. Η συναλλαγή δεν αποστέλλεται για επακόλουθη διεκπεραίωση στην τράπεζα εμπόρου.
Η πύλη μπορεί να δημιουργήσει πολλαπλές συναλλαγές αντιστροφής χρέωσης (chargeback) για μία μόνο παραγγελία. Μπορείτε να εκτελέσετε επακόλουθες συναλλαγές για μια παραγγελία που περιέχει μια συναλλαγή αντιστροφής χρέωσης (chargeback), για παράδειγμα ακυρώσεις ή επιστροφές χρημάτων.
Μια επιτυχώς καταγεγραμμένη συναλλαγή CHARGEBACK επιστρέφει τα ακόλουθα πεδία στις αποκρίσεις συναλλαγής RETRIEVE TRANSACTION και RETRIEVE ORDER:
- order.status
Όταν δημιουργείται μια συναλλαγή αντιστροφής χρέωσης (chargeback), η κατάσταση της αντίστοιχης παραγγελίας ενημερώνεται για να υποδηλώνει ότι υπάρχει μια διαφωνία που έχει εγείρει ένας πληρωτής.
- order.status
Το DISPUTED υποδεικνύει ότι έχει ανακύψει διαφορά, αλλά δεν έχουν κινηθεί ακόμη χρήματα.
- order.status
Το CHARGEBACK_PROCESSED υποδηλώνει ότι διεκπεραιώνεται μια αξίωση αντιστροφής χρέωσης (chargeback) και ότι τα χρήματα θα μετακινηθούν είτε από είτε προς τον λογαριασμό εμπόρου.
- order.status
- order.chargeback.amount - Ποσό αντιστροφής χρέωσης (chargeback).
- order.chargeback.currency - Νόμισμα αντιστροφής χρέωσης (chargeback).
- Αντικείμενο transaction.dispute - Πληροφορίες σχετικά με τη διαφορά αντιστροφής χρέωσης (chargeback), για παράδειγμα συμβάν διαφοράς και ημερομηνία.
- transaction.type - CHARGEBACK
- transaction.source - SERVICE_PROVIDER
- gatewayEntryPoint - SERVICE_PROVIDER_API
Disbursement
Με τη συναλλαγή DISBURSEMENT, μπορείτε να στείλετε χρήματα σε λογαριασμό κάρτας πληρωτή, για παράδειγμα για κέρδη τυχερών παιχνιδιών ή στοιχημάτων ή όταν πληρώνετε για λογαριασμό πιστωτικής κάρτας πληρωτή.
Σε ένα αίτημα DISBURSEMENT, δεν απαιτούνται οι λεπτομέρειες χρέωσης και αποστολής του πληρωτή και δεν ισχύει η επικύρωση κωδικού ασφαλείας κάρτας (CSC).
Μια συναλλαγή DISBURSEMENT μπορεί να είναι μια αρχική συναλλαγή (χωρίς προηγούμενες σχετικές συναλλαγές) ή μια επακόλουθη συναλλαγή μετά από VERIFY που χρησιμοποιείται για την επαλήθευση των λεπτομερειών του λογαριασμού του πληρωτή.
| Διεύθυνση URL | https://ibanke-commerce.nbg.gr/api/rest/version/72/merchant/<merchant_ID>/order/<order_ID>/transaction/<transaction_ID> |
| Μέθοδος HTTP | PUT |
{
"apiOperation": "DISBURSEMENT",
"disbursementType": "GAMING_WINNINGS",
"order": {
"amount": "100.00",
"currency": "EUR"
},
"sourceOfFunds": {
"token": "<token>"
}
}
Pay
Η συναλλαγή PAY (γνωστή και ως "αγορά" ή "πώληση") συνδυάζει ένα αίτημα AUTHORIZE και ένα αίτημα CAPTURE σε ένα μήνυμα. Μια μεμονωμένη συναλλαγή εγκρίνει την πληρωμή και μεταφέρει χρήματα από τον λογαριασμό του πληρωτή σας στον λογαριασμό σας με μία κίνηση. Μπορείτε να δώσετε μια ένδειξη στο αίτημα PAY για μεταχρονολόγηση της έγκρισης. Για περισσότερες πληροφορίες, βλ. Μεταχρονολόγηση εγκρίσεων.
Μια συναλλαγή PAY μπορεί να είναι μια αρχική συναλλαγή (χωρίς προηγούμενες σχετικές συναλλαγές) ή μια επακόλουθη συναλλαγή μετά από αίτημα VERIFY που χρησιμοποιείται για την επαλήθευση των λεπτομερειών του λογαριασμού του πληρωτή. Στην τελευταία περίπτωση, οι λεπτομέρειες της κάρτας στα αιτήματα VERIFY και PAY πρέπει να ταιριάζουν.
Το επίπεδο βεβαιότητας παραγγελίας για μια συναλλαγή PAY ορίζεται σε FINAL. Για περισσότερες πληροφορίες, βλ. Ορισμός βεβαιότητας παραγγελίας.
| Διεύθυνση URL | https://ibanke-commerce.nbg.gr/api/rest/version/72/merchant/<merchant_ID>/order/<order_ID>/transaction/<transaction_ID> |
| Μέθοδος HTTP | PUT |
{
"apiOperation": "PAY",
"order": {
"amount": "100.00",
"currency": "EUR"
},
"sourceOfFunds": {
"token": "<token>"
}
}
Χρήση αυτόματης δέσμευσης
Η αυτόματη δέσμευση είναι μια παραλλαγή της συναλλαγής PAY που επιτρέπει σε έναν έμπορο να πραγματοποιήσει μια συναλλαγή PAY με μια τράπεζα εμπόρου που υποστηρίζει μόνο συναλλαγές AUTHORIZE και CAPTURE. Όταν η πύλη λαμβάνει ένα αίτημα PAY και προσδιορίζει ότι η τράπεζα εμπόρου δεν το υποστηρίζει, η πύλη μετατρέπει αυτόματα το αίτημα PAY σε αίτημα AUTHORIZE, ακολουθούμενο από ένα αίτημα CAPTURE που ενεργοποιείται αυτόματα.
Για να το κάνετε αυτό, πρέπει να έχετε ενεργοποιημένο το δικαίωμα PAY στο προφίλ εμπόρου σας από τον your payment service provider. Το αναγνωριστικό συναλλαγής και για τα δύο αιτήματα AUTHORIZE και CAPTURE είναι το αναγνωριστικό συναλλαγής που δώσατε στο αρχικό αίτημα PAY. Στην απόκριση PAY, το πεδίο transaction.type υποδεικνύει την τελευταία συναλλαγή που επιχειρήθηκε για να εκπληρωθεί το αίτημα (AUTHORIZE ή CAPTURE).
Μπορείτε να χρησιμοποιήσετε την πράξη RETRIEVE TRANSACTION για να ανακτήσετε τα αποτελέσματα μιας αυτόματης δέσμευσης. Επιστρέφεται το αποτέλεσμα της τελευταίας συναλλαγής που επιχειρήθηκε για την εκπλήρωση του αιτήματος.
Μπορείτε να ακυρώσετε μια συναλλαγή PAY αυτόματης δέσμευσης χρησιμοποιώντας τη συναλλαγή VOID. Όταν στέλνετε ένα αίτημα VOID για αυτόματη δέσμευση, η πύλη:
- Επιχειρεί μια συναλλαγή VOID για τη συναλλαγή CAPTURE.
- Αν αυτή η πρώτη συναλλαγή VOID είναι επιτυχής, επιχειρείται μια δεύτερη συναλλαγή VOID για τη συναλλαγή AUTHORIZATION. Αν η πρώτη συναλλαγή VOID είναι ανεπιτυχής, η απόκριση υποδεικνύει ότι η συναλλαγή VOID απέτυχε και δεν επιχειρείται δεύτερη συναλλαγή VOID.
Referral
Η συναλλαγή REFERRAL απαιτείται όταν μια συναλλαγή AUTHORIZE ή PAY αποτύχει με μια απόκριση τράπεζας εμπόρου "Αναφορά στον εκδότη" (δίνεται στο πεδίο response.gatewaycode της απόκρισης).
Ενδέχεται να ζητηθεί από τον πληρωτή να παράσχει πρόσθετες πληροφορίες προκειμένου ο εκδότης να εγκρίνει τη συναλλαγή και να παράσχει έναν κωδικό έγκρισης ή ένα αναγνωριστικό μη αυτόματης έγκρισης.
Χρησιμοποιήστε τη συναλλαγή REFERRAL για να υποβάλετε ξανά την αναφερόμενη αρχική συναλλαγή ως νέα συναλλαγή AUTHORIZE ή PAY με κωδικό έγκρισης που λαμβάνεται από τον εκδότη.
| Διεύθυνση URL | https://ibanke-commerce.nbg.gr/api/rest/version/72/merchant/<merchant_ID>/order/<order_ID>/transaction/<transaction_ID> |
| Μέθοδος HTTP | PUT |
{
"apiOperation": "REFERRAL",
"transaction": {
"authorizationCode": "123456"
}
}
Refund
Με τη συναλλαγή REFUND, μπορείτε να πιστώσετε χρήματα για μια υπάρχουσα παραγγελία πίσω στον λογαριασμό του πληρωτή αν, για παράδειγμα, επιστρέψει ανεπιθύμητα, λανθασμένα ή ελαττωματικά αγαθά. Επιστροφές χρημάτων μπορούν να πραγματοποιηθούν μόνο όταν η μεταφορά χρημάτων έχει ολοκληρωθεί μέσω συναλλαγής PAY, CAPTURE ή STANDALONE CAPTURE.
Μπορείτε να εκτελέσετε οποιονδήποτε αριθμό συναλλαγών REFUND για την αρχική συναλλαγή, αλλά δεν μπορείτε να επιστρέψετε περισσότερα από το συνολικό ποσό που λαμβάνεται μέσω των συναλλαγών PAY ή CAPTURE που συσχετίζονται με την παραγγελία.
| Διεύθυνση URL | https://ibanke-commerce.nbg.gr/api/rest/version/72/merchant/<merchant_ID>/order/<order_ID>/transaction/<transaction_ID> |
| Μέθοδος HTTP | PUT |
{
"apiOperation": "REFUND",
"transaction": {
"amount": "100.00",
"currency": "EUR"
}
}
Χρήση έγκρισης επιστροφής χρημάτων
Πριν από την υποβολή του αιτήματος επιστροφής χρημάτων στην τράπεζα εμπόρου για συμψηφισμό και τακτοποίηση (settlement), από προεπιλογή, η πύλη προσπαθεί αυτόματα να εγκρίνει την επιστροφή χρημάτων σας με τον εκδότη (όπου υποστηρίζεται από την τράπεζα εμπόρου). Αυτό επιτρέπει στους εκδότες να επαληθεύουν τις λεπτομέρειες της κάρτας που παρέχονται στο αίτημα επιστροφής χρημάτων για να διασφαλίσουν ότι η επιστροφή χρημάτων είναι επιτυχής.
Η έγκριση της επιστροφής χρημάτων εκτελείται online και επιστρέφει απόκριση σε πραγματικό χρόνο (real time). Αυτό έχει πολλά οφέλη:
- Λαμβάνετε άμεση ειδοποίηση από τους εκδότες καρτών αν δεν είναι δυνατή η επιστροφή χρημάτων και μπορείτε να προβείτε στις κατάλληλες ενέργειες. Για παράδειγμα, αν η κάρτα που χρησιμοποιήθηκε για τη συναλλαγή REFUND δεν είναι πλέον έγκυρη, ο εκδότης απορρίπτει την έγκριση επιστροφής χρημάτων. Μπορείτε να επικοινωνήσετε με τον πληρωτή για να κανονίσετε την επιστροφή χρημάτων μέσω διαφορετικού μέσου πληρωμής.
- Ο εκδότης της κάρτας λαμβάνει άμεση ειδοποίηση για το αίτημα επιστροφής χρημάτων, το οποίο επιτρέπει στους εκδότες να εμφανίζουν άμεσα πληροφορίες σχετικά με την επιστροφή χρημάτων στον πληρωτή. Τους επιτρέπει επίσης να διαχειρίζονται αποτελεσματικά τα ερωτήματα/παράπονα των πληρωτών.
Αν δεν θέλετε η πύλη να υποβάλλει αιτήματα έγκρισης για τις συναλλαγές REFUND, επικοινωνήστε με τον your payment service provider για να ενεργοποιήσετε το δικαίωμα "Ενεργοποίηση επιστροφών χρημάτων χωρίς εγκρίσεις". Ακόμη και όταν έχετε ενεργοποιημένο αυτό το δικαίωμα, μπορείτε να ζητήσετε έγκριση για μια συγκεκριμένη επιστροφή χρημάτων ορίζοντας το πεδίο action.refundAuthorization σε true στο αίτημα REFUND.
Αν η έγκριση επιστροφής χρημάτων είναι επιτυχής, η πύλη πληρωμών προχωρά στην επιστροφή των χρημάτων. Το αποτέλεσμα της συναλλαγής REFUND επιστρέφεται στην απόκριση. Μπορείτε να δείτε τον κωδικό έγκρισης που λαμβάνεται από τον εκδότη στο Merchant Administration.
Επιστροφή χρημάτων για συγκεκριμένη δέσμευση
Αν εκτελούνται πολλαπλές δεσμεύσεις για μία παραγγελία, πρέπει να προσδιορίσετε για ποιες δεσμεύσεις πρέπει να γίνει επιστροφή χρημάτων κατά την επιστροφή χρημάτων για το σύνολο ή μέρος της παραγγελίας:
- Για να γίνει επιστροφή χρημάτων μιας συγκεκριμένης δέσμευσης στο Merchant Administration, επιλέξτε τη στοχευμένη δέσμευση στην ενότητα "Επιστροφή χρημάτων" και εισαγάγετε το ποσό επιστροφής χρημάτων. Αν η παραγγελία έχει πολλαπλές δεσμεύσεις, εμφανίζεται ένα νέο παράθυρο UI που σας επιτρέπει να επιλέξετε για ποια δέσμευση θα γίνει επιστροφή χρημάτων.
- Για επιστροφή χρημάτων για μια συγκεκριμένη δέσμευση με αίτημα API, συμπεριλάβετε το πεδίο transaction.targetTransactionld στο αίτημα για να προσδιορίσετε τη συγκεκριμένη δέσμευση που θα επιστραφεί και ορίστε το στο ID συναλλαγής του ισχύοντος αιτήματος CAPTURE.
Χρήση επιπλέον πιστωτικών υπολοίπων
Το συνολικό ποσό επιστροφής χρημάτων για μια παραγγελία μπορεί να υπερβαίνει το ποσό που δεσμεύτηκε επιτυχώς, εφόσον το δικαίωμα "Εκτέλεση επιστροφής χρημάτων στο πιστωτικό υπόλοιπο" είναι ενεργοποιημένο στο προφίλ εμπόρου σας.
Το πιστωτικό υπόλοιπο που επιτρέπεται πάνω από το δεσμευμένο ποσό για συναλλαγές API μπορεί να διαμορφωθεί βάσει νομίσματος στη σελίδα Admin > Ρυθμίσεις ενοποίησης του Merchant Administration. Αν δεν ορίσετε ένα όριο επιστροφής πιστωτικού υπολοίπου για ένα νόμισμα, οι επιστροφές πιστωτικού υπολοίπου απορρίπτονται για παραγγελίες σε αυτό το νόμισμα.
Όταν υποβάλλετε μια επιστροφή χρημάτων, το συνολικό ποσό που επιστρέφεται για την παραγγελία (συμπεριλαμβανομένης της επιχειρούμενης επιστροφής) δεν πρέπει να υπερβαίνει το συνολικό ποσό που έχει δεσμευτεί για αυτήν την παραγγελία πάνω από το μέγιστο πιστωτικό υπόλοιπο που επιτρέπεται. Για παράδειγμα, αν υποβάλλετε επιπλέον πιστωτικό υπόλοιπο μέσω API για μια παραγγελία όπου το συνολικό δεσμευμένο ποσό είναι 100 USD και έχετε ορίσει το όριο του πιστωτικού υπολοίπου για συναλλαγές API σε 20 USD, μπορείτε να επιστρέψετε χρήματα έως και 120 USD.
Standalone Capture
Μια συναλλαγή STANDALONE CAPTURE είναι μια συναλλαγή CAPTURE όπου η έγκριση πραγματοποιήθηκε εκτός της πύλης. Κατά την υποβολή ενός αιτήματος STANDALONE CAPTURE στην πύλη, πρέπει να παρέχετε τον εξωτερικά δημιουργημένο κωδικό έγκρισης στο πεδίο transaction.authorizationCode. Πρέπει επίσης να δώσετε όλες τις λεπτομέρειες της κάρτας που συνήθως δίνετε ως υποχρεωτικά πεδία σε μια συναλλαγή AUTHORIZATION, καθώς η πύλη δεν διαθέτει ακόμη αυτές τις πληροφορίες λόγω της εξωτερικής έγκρισης.
Μπορείτε να υποβάλετε μια STANDALONE CAPTURE αν έχετε ενεργοποιημένο το δικαίωμα "Εκτέλεση αυτόνομων δεσμεύσεων" στο προφίλ εμπόρου σας.
Αν πρέπει να δεσμεύσετε ένα ποσό μεγαλύτερο από αυτό που έχετε εγκρίνει, βλ. Χρήση δεσμεύσεων πιστωτικού υπολοίπου.
Μπορείτε να δώσετε έναν δείκτη στο αίτημα STANDALONE CAPTURE για να υποδείξετε ότι η εξωτερική έγκριση είναι μια μεταχρονολογημένη έγκριση, όταν χρειάζεται. Για περισσότερες πληροφορίες, βλ. Μεταχρονολόγηση εγκρίσεων.
| Διεύθυνση URL | https://ibanke-commerce.nbg.gr/api/rest/version/72/merchant/<merchant_ID>/order/<order_ID>/transaction/<transaction_ID> |
| Μέθοδος HTTP | PUT |
{
"apiOperation": "CAPTURE",
"order": {
"amount": "100.00",
"currency": "EUR"
},
"sourceOfFunds": {
"token": "<token>"
},
"transaction": {
"authorizationCode": "123456",
"amount": "100.00",
"currency": "EUR"
},
}
Standalone Refund
Μια συναλλαγή STANDALONE REFUND είναι μια συναλλαγή REFUND που σας επιτρέπει να μεταφέρετε χρήματα από τον λογαριασμό σας πίσω στον πληρωτή χωρίς προηγούμενη αγορά. Μπορείτε να χρησιμοποιήσετε μια συναλλαγή STANDALONE REFUND όταν θέλετε να πιστώσετε τον λογαριασμό του πληρωτή χωρίς να συσχετίσετε αυτήν την πίστωση με προηγούμενη συναλλαγή.
| Διεύθυνση URL | https://ibanke-commerce.nbg.gr/api/rest/version/72/merchant/<merchant_ID>/order/<order_ID>/transaction/<transaction_ID> |
| Μέθοδος HTTP | PUT |
{
"apiOperation": "REFUND",
"sourceOfFunds": {
"token": "<token>"
},
"transaction": {
"amount": "100.00",
"currency": "EUR"
}
}
Update Authorization
Η συναλλαγή UPDATE AUTHORIZATION σας επιτρέπει να κάνετε τα εξής:
- Να παρατείνετε την περίοδο ισχύος μιας υπάρχουσας έγκρισης.
- Να αυξήσετε ή να μειώσετε προαιρετικά το ποσό έγκρισης.
Να αυξήσετε ή να μειώσετε προαιρετικά το ποσό έγκρισης, μην υποβάλετε το πεδίο transaction.amount στο αίτημα. Η ενημερωμένη ημερομηνία και ώρα λήξης της έγκρισης επιστρέφεται στο πεδίο authorizationResponse.autoExpiry στην απόκριση RETRIEVE TRANSACTION.
Αν παρέχετε ένα ποσό συναλλαγής που είναι μεγαλύτερο από το ποσό της υπάρχουσας έγκρισης, το ποσό έγκρισης ενημερώνεται στο νέο ποσό. Για παράδειγμα, αν το υπάρχον ποσό έγκρισης είναι 100 δολάρια ΗΠΑ και δηλώσετε 120 δολάρια ΗΠΑ ως ποσό συναλλαγής στο αίτημα UPDATE AUTHORIZATION, το νέο διαθέσιμο ποσό έγκρισης είναι 120 δολάρια ΗΠΑ.
Αν παρέχετε ένα ποσό συναλλαγής που είναι μικρότερο από το ποσό της υπάρχουσας έγκρισης, το ποσό έγκρισης ενημερώνεται στο νέο ποσό. Για παράδειγμα, αν το υπάρχον ποσό έγκρισης είναι 100 δολάρια ΗΠΑ και δηλώσετε 80 δολάρια ΗΠΑ ως ποσό συναλλαγής στο αίτημα UPDATE AUTHORIZATION, το νέο διαθέσιμο ποσό έγκρισης είναι 80 δολάρια ΗΠΑ. Η πύλη επεξεργάζεται αυτόματα ένα αίτημα αίτηση αντιλογισμού για το υπόλοιπο ποσό έγκρισης ύψους 20 USD (όπου υποστηρίζεται για την τράπεζα εμπόρου).
Η πύλη μπορεί να ενημερώσει μια υπάρχουσα έγκριση μόνο αν πληρούνται οι ακόλουθες συνθήκες:
- Το προφίλ εμπόρου σας στην πύλη πρέπει να έχει ενεργοποιηθεί για το δικαίωμα "Ενημέρωση έγκρισης" από τον your payment service provider.
- Το νόμισμα παραγγελίας πρέπει να ταιριάζει με το νόμισμα στην υπάρχουσα έγκριση.
- Η υφιστάμενη έγκριση πρέπει να είναι έγκυρη, επιτυχής και πλήρως εγκεκριμένη.
- Για συναλλαγές με κάρτα Mastercard, η αύξηση του ποσού έγκρισης παρατείνει αυτόματα την περίοδος εγκυρότητας της έγκρισης. Για άλλα είδη καρτών, οι κανόνες του προγράμματος καθορίζουν την επίδραση στην περίοδο ισχύος.
- Η πράξη UPDATE AUTHORIZATION δεν υποστηρίζεται πλήρως για τράπεζες εμπόρου S2I οποιουδήποτε είδους κάρτας. Μπορούν να μειώσουν μόνο το ποσό έγκρισης χρησιμοποιώντας αυτήν την πράξη.
| Διεύθυνση URL | https://ibanke-commerce.nbg.gr/api/rest/version/72/merchant/<merchant_ID>/order/<order_ID>/transaction/<transaction_ID> |
| Μέθοδος HTTP | PUT |
{
"apiOperation": "UPDATE_AUTHORIZATION"
}
Διαχείριση συνόλων παραγγελιών
Μετά από ένα επιτυχές αίτημα UPDATE AUTHORIZATION (για κάρτα ή PayPal), το ποσό παραγγελίας (order.amount) και το συνολικό εγκεκριμένο ποσό (order.totalAuthorizedAmount) ενημερώνονται στο ποσό συναλλαγής (transaction.amount) για τη συναλλαγή UPDATE AUTHORIZATION. Αυτό ισχύει ανεξάρτητα από το αν η συναλλαγή UPDATE AUTHORIZATION υποβλήθηκε στην τράπεζα εμπόρου ή αν εγκρίθηκε αυτόματα από την πύλη (response.gatewayCode = APPROVED_AUTO).
Αν επιλέξετε να παρακάμψετε την ενημέρωση έγκρισης για ένα αίτημα CAPTURE πιστωτικού υπολοίπου (υποβάλλοντας transaction.authorizationAdjustmentActions = NO_ACTION, βλ. Χρήση δεσμεύσεων πιστωτικού υπολοίπου) και η πύλη υποβάλλει ένα αίτημα CAPTURE πιστωτικού υπολοίπου στην τράπεζα εμπόρου, τα συνολικά ποσά της παραγγελίας δεν ενημερώνονται.
Διαχείριση μερικών συνόλων παραγγελιών
Μπορείτε να δώσετε τα παρακάτω ποσά μερικών συνόλων στο αίτημα UPDATE AUTHORIZATION για πληρωμές με κάρτα ή PayPal:
- order.itemAmount
- order.shippingAndHandlingAmount
- order.taxAmount
- order.discount.amount (πληρωμές με κάρτα μόνο)
- order.gratuityAmount (πληρωμές με κάρτα μόνο)
Η παροχή του order.cashbackAmount στο αίτημα UPDATE AUTHORIZATION δεν υποστηρίζεται.
Η πύλη δεν επαληθεύει αν τα μερικά ποσά αθροίζονται στο transaction.amount (order.amount).
Πρόσθετο τέλος
Μπορείτε να ενημερώσετε ένα ποσό πρόσθετου τέλους στο αίτημα UPDATE AUTHORIZATION χρησιμοποιώντας ένα από τα ακόλουθα πεδία:
- order.merchantCharge.amount - Χρησιμοποιήστε αυτό το πεδίο αν δίνετε ένα εκ των προτέρων υπολογισμένο ποσό πρόσθετου τέλους.
- order.merchantCharge.type - Ορίστε αυτό το πεδίο σε SURCHARGE για να υποδείξετε ότι ο τύπος χρέωσης είναι πρόσθετο τέλος.
- order.netAmount - Χρησιμοποιήστε αυτό το πεδίο αν η πύλη υπολογίζει το ποσό του πρόσθετου τέλους (βάσει των κανόνων πρόσθετου τέλους). Το καθαρό ποσό είναι το πληρωτέο ποσό για την παραγγελία πριν από την εφαρμογή του πρόσθετου τέλους.
Verify
Η συναλλαγή VERIFY σάς επιτρέπει να επαληθεύσετε τις λεπτομέρειες λογαριασμού του πληρωτή πριν πραγματοποιήσετε μια συναλλαγή PAY ή AUTHORIZE. Επαληθεύει τις λεπτομέρειες πληρωμής χρησιμοποιώντας τη μέθοδο επαλήθευσης που υποστηρίζεται από την τράπεζα εμπόρου. Για παράδειγμα, αν η πύλη προσδιορίσει ότι η τράπεζα εμπόρου υποστηρίζει την Υπηρεσία επαλήθευσης διεύθυνσης (AVS), η πύλη στέλνει στην τράπεζα εμπόρου μια συναλλαγή AVS Only με ποσό συναλλαγής μηδέν και τις λεπτομέρειες διεύθυνσης του πληρωτή για λήψη του αποτελέσματος της επαλήθευσης.
| Διεύθυνση URL | https://ibanke-commerce.nbg.gr/api/rest/version/72/merchant/<merchant_ID>/order/<order_ID>/transaction/<transaction_ID> |
| Μέθοδος HTTP | PUT |
{
"apiOperation": "VERIFY",
"order": {
"currency": "EUR"
},
"sourceOfFunds": {
"token": "<token>"
}
}
Void
Η συναλλαγή VOID επιχειρεί να καταργήσει ή να αντιλογίσει αμέσως ένα προηγούμενο αίτημα συναλλαγής.
Μπορείτε να ακυρώσετε τις συναλλαγές AUTHORIZE, CAPTURE, PAY, REFUND, STANDALONE CAPTURE, STANDALONE REFUND και UPDATE AUTHORIZATION.
Για συναλλαγή AUTHORIZE, μια συναλλαγή VOID αποδεσμεύει αμέσως τυχόν δεσμευμένα κεφάλαια. Για όλους τους άλλους τύπους συναλλαγών, μια συναλλαγή VOID αποτρέπει την εκτέλεση μεταφοράς κεφαλαίων.
Για την εκτέλεση VOID άλλων συναλλαγών, δεν αποστέλλονται στην τράπεζα εμπόρου για διεκπεραίωση στο τέλος της ημέρας. Μόλις η τράπεζα εμπόρου στείλει μια συναλλαγή για διεκπεραίωση, η πράξη VOID API αποτυγχάνει και θα πρέπει να πραγματοποιήσετε REFUND.
| Διεύθυνση URL | https://ibanke-commerce.nbg.gr/api/rest/version/72/merchant/<merchant_ID>/order/<order_ID>/transaction/<transaction_ID> |
| Μέθοδος HTTP | PUT |
{
"apiOperation": "VOID",
"transaction": {
"targetTransactionId": "<ID_of_transaction_to_be_voided>"
}
}