- Κατευθυντήριες οδηγίες ενοποίησης
- Υποστηριζόμενες δυνατότητες
- Πρόσθετο τέλος
Πρόσθετο τέλος
Το πρόσθετο τέλος είναι ένα πρόσθετο ποσό που χρεώνεται από τον έμπορο για κάλυψη του κόστους αποδοχής πληρωμών με κάρτα. Η λειτουργικότητα πρόσθετου τέλους του American Express PSP σας επιτρέπει να εφαρμόσετε ένα πρόσθετο τέλος σε μια συναλλαγή βάσει των ακόλουθων παραμέτρων:
- σημείο εισόδου πύλης, για παράδειγμα, Hosted Checkout, Web-Services API
- τρόπος πληρωμής, για παράδειγμα, Mastercard, Visa, American Express
- μέθοδος χρηματοδότησης για παράδειγμα, πίστωση, χρέωση
- νόμισμα
Για να επιτρέψετε στην πύλη να υπολογίσει ένα πρόσθετο τέλος για μια συναλλαγή, θα πρέπει διαμορφώσετε το πρόσθετο τέλος στο Merchant Administration. Εναλλακτικά, μπορείτε να δώσετε ένα προ-υπολογισμένο πρόσθετο τέλος σε μια παραγγελία αν η ενοποίηση γίνεται χρησιμοποιώντας το Web-Services API/Batch.
Προαπαιτούμενα
- Η δυνατότητα επιβολής πρόσθετου τέλους θα πρέπει να έχει ενεργοποιηθεί στο προφίλ εμπόρου σας με το American Express PSP.
- Θα πρέπει διαμορφώσετε τους κανόνες πρόσθετου τέλους στο Merchant Administration, για να επιτρέψετε στην πύλη να υπολογίσει το πρόσθετο τέλος.
Ενοποίηση για χρήση πρόσθετου τέλους
Η πύλη υποστηρίζει το πρόσθετο τέλος σε συναλλαγές χρησιμοποιώντας τις ακόλουθες μεθόδους ενοποίησης:
Ενοποίηση μέσω Web-Services API/Batch
Μπορείτε να εφαρμόσετε ένα πρόσθετο τέλος σε μια παραγγελία χρησιμοποιώντας μία από τις ακόλουθες επιλογές:
- πρόσθετο τέλος που υπολογίζεται από την πύλη
Για να επιτρέψετε στην πύλη να υπολογίσει ένα πρόσθετο τέλος, συμπληρώστε το ακόλουθο πεδίο σε ένα αίτημα
Authorize/PayήUpdate Session:order.netAmount: Αυτό είναι το πληρωτέο ποσό για την παραγγελία πριν από την εφαρμογή του πρόσθετου τέλους.
Μην συμπληρώσετε το πεδίοorder.amountστο αίτημα. Ανατρέξτε στην ενότητα Συχνές ερωτήσεις παρακάτω.Μπορείτε να υποβάλετε ένα αίτημα
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 για να ζητήσετε λεπτομέρειες προγράμματος κάρτας/χρηματοδότησης οι οποίες θα σας βοηθήσουν να αξιολογήσετε και να εφαρμόσετε το σωστό πρόσθετο τέλος για μια κάρτα. Για περισσότερες πληροφορίες, βλ. Συχνές ερωτήσεις παρακάτω.- πρόσθετο τέλος που υπολογίζεται από τον έμπορο
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.
Για να εφαρμόσετε ένα πρόσθετο τέλος σε μια πληρωμή Hosted Checkout, συμπληρώστε το παρακάτω πεδίο στο αίτημα Hosted Checkout (συνάρτηση Checkout.configure() ή πράξη Create Checkout Session ανάλογα με τη ροή checkout):
order.netAmount: Το πληρωτέο ποσό για την παραγγελία πριν από την εφαρμογή του πρόσθετου τέλους.
order.amount στο αίτημα. Ανατρέξτε στην ενότητα Συχνές ερωτήσεις παρακάτω.Μπορείτε να υποβάλετε ένα αίτημα Retrieve Transaction/Retrieve Order για την ανάκτηση των λεπτομερειών πρόσθετου τέλους:
order.surchargeAmount: Το πρόσθετο τέλος υπολογίζεται από την πύλη βάσει των κανόνων για τη χρέωση πρόσθετων τελών.order.amount: Αυτό είναι καθαρό ποσό συν το πρόσθετο τέλος.
Ο πληρωτής θα μπορεί να δει το πρόσθετο τέλος που εφαρμόζεται για την κάρτα που έχει εισάγει και μπορεί να επιλέξει να προχωρήσει με το νέο συνολικό ποσό, να χρησιμοποιήσει διαφορετική κάρτα ή να ακυρώσει την παραγγελία. Η απόδειξη πληρωμής που εμφανίζεται στον πληρωτή θα υποδεικνύει το ποσό του πρόσθετου τέλους που έχει εφαρμοστεί.
order.netAmount: Το πληρωτέο ποσό για την παραγγελία πριν από την εφαρμογή του πρόσθετου τέλους.order.merchantCharge.type: Ο τύπος του πρόσθετου τέλους που χρεώνετε στον πληρωτή, επί του παρόντος αναφέρεται μόνο στο πρόσθετο τέλος. Η τιμή του merchantCharge.type είναι πρόσθετο τέλος.
order.amount στο αίτημα. Ανατρέξτε στην ενότητα Συχνές ερωτήσεις παρακάτω.Μπορείτε να υποβάλετε ένα αίτημα Retrieve Transaction/Retrieve Order για την ανάκτηση των λεπτομερειών πρόσθετου τέλους:
order.merchantCharge.amount: Το ποσό του πρόσθετου τέλους που χρεώνετε στον πληρωτή, επί του παρόντος αναφέρεται μόνο στο ποσό του πρόσθετου τέλους.order.amount: Αυτό είναι καθαρό ποσό συν το πρόσθετο τέλος.
Ο πληρωτής θα μπορεί να δει το πρόσθετο τέλος που εφαρμόζεται για την κάρτα που έχει εισάγει και μπορεί να επιλέξει να προχωρήσει με το νέο συνολικό ποσό, να χρησιμοποιήσει διαφορετική κάρτα ή να ακυρώσει την παραγγελία. Η απόδειξη πληρωμής που εμφανίζεται στον πληρωτή θα υποδεικνύει το ποσό του πρόσθετου τέλους που έχει εφαρμοστεί.
Συχνές ερωτήσεις
Η πύλη θα υπολογίσει το πρόσθετο τέλος, αν συμπληρώσω τα πεδία 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: Η μέθοδος που χρησιμοποιείται από τον πληρωτή για την παροχή των χρημάτων για την πληρωμή.
Μπορείτε επίσης να χρησιμοποιήσετε αυτές τις λεπτομέρειες για υπολογίσετε το πρόσθετο τέλος βάσει της κάρτας που παρουσιάζεται από τον πληρωτή.