Πρόσθετο τέλος

Το πρόσθετο τέλος είναι ένα πρόσθετο ποσό που χρεώνεται από τον έμπορο για κάλυψη του κόστους αποδοχής πληρωμών με κάρτα. Η λειτουργικότητα πρόσθετου τέλους του Mastercard Gateway σας επιτρέπει να εφαρμόσετε ένα πρόσθετο τέλος σε μια συναλλαγή βάσει των ακόλουθων παραμέτρων:

σημείο εισόδου πύλης, για παράδειγμα, Hosted Checkout, API
τρόπος πληρωμής, για παράδειγμα, Mastercard, Visa, American Express
μέθοδος χρηματοδότησης για παράδειγμα, πίστωση, χρέωση
νόμισμα

Για να επιτρέψετε στην πύλη να υπολογίσει ένα πρόσθετο τέλος για μια συναλλαγή, θα πρέπει διαμορφώσετε το πρόσθετο τέλος στο Merchant Administration. Εναλλακτικά, μπορείτε να δώσετε ένα προ-υπολογισμένο πρόσθετο τέλος σε μια παραγγελία αν η ενοποίηση γίνεται χρησιμοποιώντας το API/Batch.

Το πρόσθετο τέλος ισχύει μόνο για πληρωμές με κάρτα που πραγματοποιούνται στην Αυστραλία και τη Νέα Ζηλανδία.

Για να καθορίσετε αν επιτρέπεται η επιβολή πρόσθετου τέλους στις πληρωμές με κάρτες στην περιοχή σας, επικοινωνήστε με τον your payment service provider ή ελέγξτε το πρόγραμμα κάρτας και τους ρυθμιστικούς κανόνες στην περιοχή σας.

ΠροαπαιτούμεναCopied to Clipboard

Η δυνατότητα επιβολής πρόσθετου τέλους θα πρέπει να έχει ενεργοποιηθεί στο προφίλ εμπόρου σας με το Mastercard Gateway.
Θα πρέπει διαμορφώσετε τους κανόνες πρόσθετου τέλους στο Merchant Administration, για να επιτρέψετε στην πύλη να υπολογίσει το πρόσθετο τέλος.

Ενοποίηση για χρήση πρόσθετου τέλουςCopied to Clipboard

Η πύλη υποστηρίζει το πρόσθετο τέλος σε συναλλαγές χρησιμοποιώντας τις ακόλουθες μεθόδους ενοποίησης:

Ενοποίηση μέσω API/Batch

Χρήση πρόσθετου τέλους WSAPI από την έκδοση 50 έως την 66.

Μπορείτε να εφαρμόσετε ένα πρόσθετο τέλος σε μια παραγγελία χρησιμοποιώντας μία από τις ακόλουθες επιλογές:

πρόσθετο τέλος που υπολογίζεται από την πύλη

Για να επιτρέψετε στην πύλη να υπολογίσει ένα πρόσθετο τέλος, συμπληρώστε το ακόλουθο πεδίο σε ένα αίτημα Authorize/Pay ή Update Session:
- order.netAmount: Αυτό είναι το πληρωτέο ποσό για την παραγγελία πριν από την εφαρμογή του πρόσθετου τέλους.
Μπορείτε να υποβάλετε ένα αίτημα Retrieve Transaction/Retrieve Order για την ανάκτηση των ακόλουθων λεπτομερειών πρόσθετου τέλους:
- order.surchargeAmount: Το πρόσθετο τέλος υπολογίζεται από την πύλη βάσει των κανόνων για τη χρέωση πρόσθετων τελών.
- order.amount: Το συνολικό ποσό για την παραγγελία, συμπεριλαμβανομένου του ποσού του πρόσθετου τέλους.
Μπορείτε επίσης να χρησιμοποιήσετε την πράξη Payment Options Inquiry για να υποβάλετε αίτημα για το υπολογισμένο ποσό πρόσθετου τέλους συμπληρώνοντας τα ακόλουθα πεδία:session.id, order.netAmount, order.currency, gatewayEntryPoint και sourceOfFunds.provided.card.prefix.
πρόσθετο τέλος που υπολογίζεται από τον έμπορο

Συμπληρώστε τα ακόλουθα πεδία σε ένα αίτημα Authorize/Pay/Standalone Capture ή Update Session:
- order.amount: Το συνολικό ποσό για την παραγγελία, συμπεριλαμβανομένου του ποσού του πρόσθετου τέλους.
- order.surchargeAmount: Το πρόσθετο τέλος, κατά περίπτωση, για τη συγκεκριμένη παραγγελία. Αυτό το ποσό θα πρέπει να περιλαμβάνεται στο συνολικό ποσό παραγγελίας που καθορίζετε στο πεδίο order.amount.
Η υποβολή ενός αιτήματος Retrieve Transaction/Retrieve Order θα επιστρέψει τις λεπτομέρειες πρόσθετου τέλους όπως παρέχονται από εσάς σε ένα αίτημα συναλλαγής συν order.netAmount (καθαρό ποσό που προκύπτει ως ποσό παραγγελίας μείον το ποσό πρόσθετου τέλους).

Μπορείτε να χρησιμοποιήσετε την πράξη Payment Options Inquiry για να ζητήσετε λεπτομέρειες προγράμματος κάρτας/χρηματοδότησης οι οποίες θα σας βοηθήσουν να αξιολογήσετε και να εφαρμόσετε το σωστό πρόσθετο τέλος για μια κάρτα. Για περισσότερες πληροφορίες, βλ. Συχνές ερωτήσεις παρακάτω.

Χρήση πρόσθετου τέλους WSAPI από την έκδοση 67 και νεότερη.

πρόσθετο τέλος που υπολογίζεται από τον έμπορο

order.amount: Το συνολικό ποσό για την παραγγελία, συμπεριλαμβανομένου του ποσού του πρόσθετου τέλους.
order.merchantCharge.amount: Το ποσό του πρόσθετου τέλους που χρεώνετε στον πληρωτή, επί του παρόντος αναφέρεται μόνο στο ποσό του πρόσθετου τέλους.
order.merchantCharge.type: Ο τύπος του πρόσθετου τέλους που χρεώνετε στον πληρωτή, επί του παρόντος αναφέρεται μόνο στο πρόσθετο τέλος. Η τιμή του merchantCharge.type είναι πρόσθετο τέλος.

Πρόσθετο τέλος που υπολογίζεται από την πύλη

order.netAmount: Αυτό είναι το πληρωτέο ποσό για την παραγγελία πριν από την εφαρμογή του πρόσθετου τέλους.
order.merchantCharge.type: Ο τύπος του πρόσθετου τέλους που χρεώνετε στον πληρωτή, επί του παρόντος αναφέρεται μόνο στο πρόσθετο τέλος. Η τιμή του merchantCharge.type είναι πρόσθετο τέλος.

Authorize - Αναφορά API [REST][NVP]

Retrieve Transaction - Αναφορά API [REST][NVP]

Payment Options Inquiry - Αναφορά API [REST][NVP]

Ενοποίηση μέσω Hosted Checkout

Το πρόσθετο τέλος μπορεί να υπολογιστεί από την πύλη μέσω του Hosted Checkout.

Χρήση πρόσθετου τέλους WSAPI από την έκδοση 50 έως την 70.

Για να εφαρμόσετε ένα πρόσθετο τέλος σε μια πληρωμή Hosted Checkout, συμπληρώστε το παρακάτω πεδίο στο αίτημα Hosted Checkout (συνάρτηση Checkout.configure() ή πράξη Create Checkout Session ανάλογα με τη ροή checkout):

order.netAmount: Το πληρωτέο ποσό για την παραγγελία πριν από την εφαρμογή του πρόσθετου τέλους.

Μην συμπληρώσετε το πεδίο order.amount στο αίτημα. Ανατρέξτε στην ενότητα Συχνές ερωτήσεις παρακάτω.

Μπορείτε να υποβάλετε ένα αίτημα Retrieve Transaction/Retrieve Order για την ανάκτηση των λεπτομερειών πρόσθετου τέλους:

order.surchargeAmount: Το πρόσθετο τέλος υπολογίζεται από την πύλη βάσει των κανόνων για τη χρέωση πρόσθετων τελών.
order.amount: Αυτό είναι καθαρό ποσό συν το πρόσθετο τέλος.

Ο πληρωτής θα μπορεί να δει το πρόσθετο τέλος που εφαρμόζεται για την κάρτα που έχει εισάγει και μπορεί να επιλέξει να προχωρήσει με το νέο συνολικό ποσό, να χρησιμοποιήσει διαφορετική κάρτα ή να ακυρώσει την παραγγελία. Η απόδειξη πληρωμής που εμφανίζεται στον πληρωτή θα υποδεικνύει το ποσό του πρόσθετου τέλους που έχει εφαρμοστεί.

Χρήση πρόσθετου τέλους WSAPI από την έκδοση 71 και νεότερη.

order.netAmount: Το πληρωτέο ποσό για την παραγγελία πριν από την εφαρμογή του πρόσθετου τέλους.
order.merchantCharge.type: Ο τύπος του πρόσθετου τέλους που χρεώνετε στον πληρωτή, επί του παρόντος αναφέρεται μόνο στο πρόσθετο τέλος. Η τιμή του merchantCharge.type είναι πρόσθετο τέλος.

Μην συμπληρώσετε το πεδίο order.amount στο αίτημα. Ανατρέξτε στην ενότητα Συχνές ερωτήσεις παρακάτω.

Μπορείτε να υποβάλετε ένα αίτημα Retrieve Transaction/Retrieve Order για την ανάκτηση των λεπτομερειών πρόσθετου τέλους:

order.merchantCharge.amount: Το ποσό του πρόσθετου τέλους που χρεώνετε στον πληρωτή, επί του παρόντος αναφέρεται μόνο στο ποσό του πρόσθετου τέλους.
order.amount: Αυτό είναι καθαρό ποσό συν το πρόσθετο τέλος.

Συχνές ερωτήσειςCopied to Clipboard

Η πύλη θα υπολογίσει το πρόσθετο τέλος, αν συμπληρώσω τα πεδία `order.netAmount` και `order.amount` στο αίτημά μου;

Η συμπλήρωση των πεδίων order.netAmount και order.amount χωρίς το order.surchargeAmount θα επιστρέψει σφάλμα επειδή η πύλη δεν διαθέτει επαρκείς πληροφορίες για να υπολογίσει το πρόσθετο τέλος. Η πύλη απαιτεί να συμπληρώσετε είτε το πεδίο order.netAmount ΕΙΤΕ το πεδίο order.amount.

Αν συμπληρώσετε και τα τρία πεδία, τότε η πύλη δεν θα υπολογίσει το πρόσθετο τέλος, αντ' αυτού θα χρησιμοποιήσει το ποσό του πρόσθετου τέλους που παρασχέθηκε από εσάς.

Μπορώ να εξαιρεθώ από την επιβολή πρόσθετου τέλους στις πληρωμές με κάρτες κατά την υποβολή μιας συναλλαγής;

Ναι, για να εξαιρεθείτε από το πρόσθετο τέλος,

δώστε το πεδίο order.amount στο αίτημα συναλλαγής σας για να υποδείξετε το συνολικό ποσό για την παραγγελία.

για Direct API από WSAPI έκδοση 50 έως 66,

όταν το πρόσθετο τέλος υπολογίζεται από τον έμπορο, μην δώσετε τιμή στα πεδία order.netAmount και order.surchargeAmount.
όταν το πρόσθετο τέλος υπολογίζεται από την πύλη, μην δώσετε τιμή στο πεδίο order.netAmount.

για Direct API από την έκδοση WSAPI 67 και νεότερη,

όταν το πρόσθετο τέλος υπολογίζεται από τον έμπορο, μην δώσετε τιμή στα πεδία order.netAmount, order.merchantCharge.amount και order.merchantCharge.type ως πρόσθετο τέλος.
όταν το πρόσθετο τέλος υπολογίζεται από την πύλη, μην δώσετε τιμή στα πεδία order.netAmount και order.merchantCharge.Type ως πρόσθετο τέλος.

για Hosted Checkout από WSAPI έκδοση 50 έως 70,

το πρόσθετο τέλος υπολογίζεται πάντα από την πύλη, μην δώσετε τιμή στο πεδίο order.netAmount.

για Hosted Checkout από WSAPI έκδοση 71 και νεότερη,

το πρόσθετο τέλος υπολογίζεται πάντα από την πύλη, μην δώσετε τιμή στα πεδία order.netAmount και order.merchantCharge.type ως πρόσθετο τέλος.

Αν ο πληρωτής ζητήσει επιστροφή χρημάτων, θα επιστραφεί το ποσό του πρόσθετου τέλους;

Ναι. Επειδή το πρόσθετο τέλος περιλαμβάνεται στο πεδίο order.amount και το συγκεκριμένο ποσό πρόκειται να επιστραφεί στον πληρωτή, το ποσό του πρόσθετου τέλους επιστρέφεται επίσης. Στην περίπτωση των μερικών επιστροφών χρημάτων, το ποσό του πρόσθετου τέλους θα επιστραφεί κατ' αναλογία.

Αν έχω ενεργοποιήσει τη Δυναμική μετατροπή νομισμάτων (DCC), η πύλη θα υπολογίσει το πρόσθετο τέλος τόσο στο νόμισμα του πληρωτή όσο και στο προτιμώμενο νόμισμά μου;

Ναι, η πύλη θα συμπεριλάβει το πρόσθετο τέλος που εφαρμόζεται στο ποσό της παραγγελίας, το οποίο θα επιστραφεί ως paymentTypes.card.currencyConversion.payerAmount στο νόμισμα χρέωσης του πληρωτή και ως πεδίο order.amount στο προτιμώμενο νόμισμά σας (στην απόκριση της πράξης Payment Options Inquiry).

Μπορώ να ανακτήσω τα δεδομένα ταυτοποίησης τύπου κάρτας για να υπολογίσω το πρόσθετο τέλος για μια παραγγελία;

Ναι, μπορείτε να συμπληρώσετε το πεδίο sourceOfFunds.provided.card.prefix στο αίτημα Payment Options Inquiry για να ανακτήσετε τις ακόλουθες λεπτομέρειες προγράμματος/χρηματοδότησης σχετικά με την κάρτα που χρησιμοποιείται για την πληρωμή, κάτι που μπορεί να σας βοηθήσει στις αποφάσεις σχετικά με την επιβολή πρόσθετου τέλους:

paymentTypes.card.scheme: Ο οργανισμός στον οποίο ανήκει ένα είδος κάρτας και ορίζει τους κανονισμούς λειτουργίας που διέπουν τη χρήση της.
paymentTypes.card.brand: Το εμπορικό σήμα που χρησιμοποιείται για να περιγράψει την κάρτα, το οποίο αναγνωρίζεται και είναι αποδεκτό παγκοσμίως. Για πολλούς σημαντικούς τύπους καρτών, αυτό είναι ίδιο με το όνομα του προγράμματος. Σε ορισμένες αγορές, μια κάρτα μπορεί επίσης να φέρει ένα επιπλέον εμπορικό σήμα κάποιας τοπικής εταιρείας που είναι αναγνωρισμένη και αποδεκτή στη χώρα/περιοχή προέλευσης (βλ. "Τοπική εταιρεία").
paymentTypes.card.localBrand: Το εμπορικό σήμα που χρησιμοποιείται για να περιγράψει μια κάρτα, το οποίο αναγνωρίζεται και είναι αποδεκτό εντός της χώρας/περιοχής προέλευσης. Η κάρτα μπορεί να φέρει επίσης ένα ακόμα εμπορικό σήμα που αναγνωρίζεται και είναι αποδεκτό παγκοσμίως.
paymentTypes.card.fundingMethod: Η μέθοδος που χρησιμοποιείται από τον πληρωτή για την παροχή των χρημάτων για την πληρωμή.

Αυτές οι πληροφορίες συλλέγονται από πηγές τρίτων μερών και ενδέχεται να μην είναι ακριβείς σε όλες τις περιπτώσεις.

Μπορείτε επίσης να χρησιμοποιήσετε αυτές τις λεπτομέρειες για υπολογίσετε το πρόσθετο τέλος βάσει της κάρτας που παρουσιάζεται από τον πληρωτή.