DCC
Το American Express PSP σας παρέχει τιμή συναλλάγματος πραγματικού χρόνου από πάροχο DCC για αγαθά και υπηρεσίες που τιμολογούνται στο νόμισμα της επιλογής σας. Μπορείτε να προσφέρετε αυτήν τη συναλλαγματική ισοτιμία στον πληρωτή, ο οποίος μπορεί να επιλέξει να πληρώσει είτε στο νόμισμα της επιλογής σας είτε στο νόμισμα της κάρτας. Οι κάτοχοι καρτών επωφελούνται της υπηρεσίας, γνωρίζοντας κατά τον χρόνο αγοράς ακριβώς πόσο θα χρεωθούν στο δικό τους νόμισμα.
Βασικά οφέλη
- Οι πληρωτές μπορούν να πληρώνουν για αγαθά ή υπηρεσίες στο νόμισμα τιμολόγησής τους στο σημείο πώλησης.
- Εσείς λαμβάνετε μερίδιο της προμήθειας μετατροπής συναλλάγματος.
- Η επεξεργασία της παραγγελίας γίνεται στο δικό σας νόμισμα παραγγελίας.
- Οι πληρωτές βλέπουν το ποσό της παραγγελίας στο δικό τους νόμισμα στις κινήσεις της κάρτας τους.
- Οι πληρωτές δεν βλέπουν τη χρέωση της μετατροπής συναλλάγματος στις κινήσεις της κάρτας τους (καθώς περιλαμβάνεται στην παρεχόμενη τιμή συναλλάγματος).
Προϋποθέσεις για τις τιμές συναλλάγματος
- Πρέπει να έχετε εγγραφεί στον πάροχο DCC που επιθυμείτε να χρησιμοποιήσετε.
Το American Express PSP επί του παρόντος υποστηρίζει:
- FEXCO.
Διαχείριση τιμών συναλλάγματος μέσω της πύλης
Υπάρχουν τέσσερα βασικά, αμοιβαία αποκλειόμενα, σενάρια για τη χρήση DCC σε μια συναλλαγή:
- Δεν επιθυμείτε να χρησιμοποιήσετε DCC στη συναλλαγή, για παράδειγμα αν το νόμισμα της κάρτας του πληρωτή είναι το ίδιο με το νόμισμα της επιλογής σας.
- Θα επιθυμούσατε να πραγματοποιήσετε DCC αν υπήρχε σχετική προσφορά, ωστόσο δεν υπάρχει.
- Επιθυμείτε να πραγματοποιήσετε DCC. Ο πάροχος DCC έχει πραγματοποιήσει προσφορά. Την κοινοποιήσατε στον πληρωτή και αυτός την απέρριψε.
- Επιθυμείτε να πραγματοποιήσετε DCC. Ο πάροχος DCC έχει πραγματοποιήσει προσφορά. Την κοινοποιήσατε στον πληρωτή και αυτός τη δέχτηκε.
Ζητήστε τιμή συναλλάγματος
Μπορείτε να ζητήσετε μια τιμή συναλλάγματος παρέχοντας δεδομένα για τα ακόλουθα πεδία στο αίτημα Payment Options Inquiry (apiOperation=PAYMENT_OPTIONS_INQUIRY):
order.amount.order.currency.paymentType. Αν δίνεται, πρέπει να έχει οριστεί στοCREDIT.
currencyConversion.gatewayCode=UNSUPPORTED_CARD_BRAND.Όταν καλείτε την πράξη Payment Options Inquiry μέσω του πρωτοκόλλου REST, βεβαιωθείτε ότι οι παράμετροι του αιτήματος περιλαμβάνονται στο URI (ως παράμετροι αιτήματος) και όχι στο σώμα του JSON. Ακολούθως θα βρείτε ένα δείγμα αιτήματος REST σε εξέλιξη για τιμή συναλλάγματος DCC.
curl --user merchant.TESTMERCHANT-DCC:<PASSWORD>"https://gateway-japa.americanexpress.com/api/rest/version/72/merchant/TESTMERCHANT-DCC/paymentOptionsInquiry?order.amount=123.34&order.currency=USD&sourceOfFunds.provided.card.prefix=531335999"
Αποκρίσεις κατάστασης τιμής συναλλάγματος
Το American Express PSP δίνει τις παρακάτω πληροφορίες για την προσφορά DCC. Κάποιες από αυτές θα περιλαμβάνονται στις πληροφορίες που εμφανίζετε στον πληρωτή στη σελίδα πληρωμής ή το τερματικό PED, σύμφωνα με τις απαιτήσεις του συστήματος και τις νομοθετικές απαιτήσεις.
currencyConversion.gatewayCode:QUOTE_PROVIDED: Η προσφορά έχει δοθεί.NOT_ELIGIBLE: Η DCC δεν διατίθεται για αυτήν την κάρτα ή/και το νόμισμα.UNSUPPORTED_CARD_BRAND: Δεν υποστηρίζεται το είδος κάρτας.INSUFFICIENT_INFORMATION: Λείπουν απαιτούμενα πεδία από το αίτημα.ERROR: Ο πάροχος της DCC δεν δύναται να επεξεργαστεί αυτή τη λειτουργία.
currencyConversion.provider: Ονομασία του παρόχου προσφοράς DCC.currencyConversion.providerCode: Δημιουργείται από τον πάροχο DCC, ενημερώνει για την επιτυχία ή όχι του αιτήματος προσφοράς DCC.currencyConversion.providerReceipt: Μοναδικός κωδικός αναφοράς του παρόχου DCC για την τιμή συναλλάγματος. (Δεν παρέχεται πάντα).currencyConversion.exchangeRateSource: Η υπηρεσία χρηματοοικονομικών δεδομένων που χρησιμοποιήθηκε ως πηγή για τη συναλλαγματική ισοτιμία.currencyConversion.payerExchangeRate: Η συναλλαγματική ισοτιμία που χρησιμοποιήθηκε για τη μετατροπή του ποσού της συναλλαγής στο νόμισμα του πληρωτή. Αυτό περιλαμβάνειcurrencyConversion.marginPercentage.currencyConversion.payerAmount: Το συνολικό ποσό της συναλλαγής στο νόμισμα του πληρωτή.currencyConversion.payerCurrency: Το νόμισμα της τιμής DCC που έδωσε ο πάροχος DCC.currencyConversion.marginPercentage: Την προσαύξηση της συναλλαγματικής ισοτιμίας που εφαρμόστηκε ως ποσοστό στο ποσό της συναλλαγής για την παροχή της υπηρεσίας μετατροπής.currencyConversion.exchangeRateTime: Η χρονοσήμανση που δείχνει πότε ισχύει η ισοτιμία μετατροπής.currencyConversion.quoteExpiry: Τη χρονοσήμανση που δείχνει πότε λήγει η προσφορά DCC. (Δεν παρέχεται πάντα).currencyConversion.offerText: Ένα απόσπασμα HTML που περιέχει φόρμα εισαγωγής για την προσφορά DCC. Αυτό πρέπει να δοθεί στον πληρωτή ώστε να επιλέξει.currencyConversion.requestId: Το μοναδικό αναγνωριστικό για το αίτημα προσφοράς DCC όπως δίνεται στην απόκριση στο PAYMENT_OPTIONS_INQUIRY.
Payment Options Inquiry – Αναφορά API[REST][NVP]
Χρήση της τιμής συναλλάγματος για συναλλαγή
-
Αν λάβετε τιμή συναλλάγματος από τον πάροχο DCC (
currencyConversion.gatewayCode=QUOTE_PROVIDED), μπορείτε να πραγματοποιήσετε προσφορά μετατροπής συναλλάγματος στον πληρωτή.Προσφορές τιμής συναλλάγματοςΚείμενο προσφοράς
Η Visa και η Mastercard έχουν συγκεκριμένες απαιτήσεις για την εμφάνιση των πληροφοριών DCC σε πληρωτές ώστε να διασφαλιστεί ότι ο πληρωτής λαμβάνει τις απαιτούμενες πληροφορίες ώστε να κάνει συνειδητή επιλογή. Αυτό περιλαμβάνει στοιχεία για τις χρεώσεις στην προσφορά DCC και την απόδειξη της συναλλαγής (αν ο πληρωτής αποδεχτεί την προσφορά).
Θεμελιώδεις αρχές για τους κανονισμούς της DCC:
- Ο κάτοχος της κάρτας έχει την επιλογή να πληρώσει στο νόμισμα του εμπόρου ή στο οικείο του νόμισμα με πλήρη διαφάνεια ως προς τις λεπτομέρειες της συναλλαγής.
- Ο κάτοχος της κάρτας έχει την επιλογή να αποδεχτεί ή να απορρίψει την προσφορά DCC.
- Οι όροι και οι προϋποθέσεις που σχετίζονται με τη DCC αποκαλύπτονται πλήρως στον κάτοχο της κάρτας.
Παρουσίαση προσφοράς
Θα σας δοθεί το κείμενο της προσφοράς στο
paymentTypes.card.currencyConversion.offerText. Μπορείτε να ορίσετε την τοποθεσία για το κείμενο της προσφοράς ρυθμίζοντας τοlocale=<Valid language identifier or IETF language tag of payer's locale>(π.χ.enγια τα αγγλικά,pt-BRγια τα πορτογαλικά της Βραζιλίας,es-MXγια τα ισπανικά του Μεξικού).Ένα κείμενο προσφοράς DCC σύμφωνο με την τοποθεσία σε μορφή HTML δίνεται στο
paymentTypes.card.currencyConversion.offerTextγια τις ακόλουθες τοποθεσίες:- Γαλλικά (fr_FR)
- Γερμανικά (de_DE)
- Ισπανικά του Μεξικού (es_MX)
- Κινεζικά:
- Απλοποιημένα κινεζικά (zh_CN)
- Κινεζικά του Χονγκ Κονγκ (zh_HK)
- Πορτογαλικά της Βραζιλίας (pt_BR)
- Ιαπωνικά (ja_JP)
- Ινδονησιακά (id_ID)
- Αγγλικά:
- Ηνωμένων Πολιτειών (en_US)
- Ηνωμένου Βασιλείου (en_UK)
- Αυστραλίας (en_AU)
Αν δεν υποστηρίζεται η τοποθεσία, το American Express PSP θα σας δώσει ένα κείμενο προσφοράς σύμφωνα με τα παρακάτω:
- Ο κωδικός γλώσσας αντιστοιχίζεται στην εγγύτερη υποστηριζόμενη τοποθεσία, κατά περίπτωση.
- Αν δεν ορίσετε το
interaction.localeή αν η τοποθεσία και η βασική γλώσσα δεν υποστηρίζονται, το American Express PSP θα επιχειρήσει να χρησιμοποιήσει τη ρυθμισμένη ως προεπιλεγμένη τοποθεσία. Αν αυτή η τοποθεσία και η βασική γλώσσα δεν υποστηρίζονται, η προσφορά θα παρουσιαστεί σταen_US.
Τότε ο πληρωτής μπορεί:-
Να δεχτεί την προσφορά DCC και να επιλέξει να πληρώσει στο νόμισμα της κάρτας.
Σε αυτήν την περίπτωση πραγματοποιήστε αίτημα συναλλαγής με τις παρακάτω παραμέτρους:
currencyConversion.requestIdόπως δίνεται στην απόκριση από το American Express PSP.currencyConversion.uptake=ACCEPTED.
Δώστε στον πληρωτή το κείμενο της απόδειξης που δίνεται στο
paymentTypes.card.currencyConversion.receiptTextστην απόκριση του αιτήματοςRETRIEVE_TRANSACTION. Αυτό χρησιμοποιεί τις ίδιες τοπικές ρυθμίσεις με το κείμενο προσφοράς. -
Να απορρίψει την προσφορά DCC και να επιλέξει να πληρώσει στο νόμισμα παραγγελίας (
currencyConversion.uptake=DECLINED).Σε αυτήν την περίπτωση πραγματοποιήστε αίτημα συναλλαγής με τις παρακάτω παραμέτρους:
currencyConversion.requestIdόπως δίνεται στην απόκριση από το American Express PSP.currencyConversion.uptake=DECLINED.
-
Αν λάβετε κάποιο από τα παρακάτω στην απόκριση Payment Options Inquiry:
currencyConversion.gatewayCode=UNSUPPORTED_CARD_BRANDcurrencyConversion.gatewayCode=NOT_ELIGIBLEcurrencyConversion.gatewayCode=ERROR
Πρέπει να ορίσετε το
currencyConversion.uptake=NOT_AVAILABLEστο αίτημα συναλλαγής σας και να δώσετε το σωστόcurrencyConversion.requestId.
Αυτό επιτρέπει στον πάροχο DCC να χρησιμοποιήσει τα δεδομένα για σκοπούς ανάλυσης και αναφοράς.
Αν έχετε λάβει προσφορά εκτός της πύλης, πρέπει να παρέχετε ρητώς τις λεπτομέρειες DCC που σας δόθηκαν στο αίτημα συναλλαγής από τον πάροχο DCC.
Αν θέλετε να χρησιμοποιήσετε το Ταυτοποίηση API για την ταυτοποίηση του πληρωτή πριν από την εκτέλεση της πληρωμής, πρέπει να διαβιβάσετε τα πεδία DCC όπως περιγράφεται στην πράξη Initiate Authentication. Μόλις ολοκληρωθεί η ταυτοποίηση πληρωτή, μπορείτε να προχωρήσετε στην πληρωμή για την ίδια παραγγελία με μια πράξη Authorize ή Pay και να παρέχετε το authentication.transactionId που παρείχατε στις πράξεις Initiate Authentication και Authenticate Payer. Δεν χρειάζεται να διαβιβάσετε ξανά τα πεδία DCC στην οικονομική σας συναλλαγή, επειδή μεταφέρονται από τη συναλλαγή ταυτοποίησης πληρωτή στην οποία γίνεται αναφορά.
Είσοδος μετατροπής νομισμάτων - Αναφορά API [REST][NVP]
Συναλλαγές δέσμευσης/επιστροφής DCC
Δεσμεύσεις
Οι λεπτομέρειες της DCC πρέπει να παρέχονται στο αίτημα συναλλαγής Authorize. Οι λεπτομέρειες της DCC ισχύουν για τις δεσμεύσεις στην παραγγελία.
Για πλήρη δέσμευση, θα χρησιμοποιηθούν τα στοιχεία DCC από την Έγκριση αιτήματος.
Για μερικές ή πλεονάζουσες δεσμεύσεις το American Express PSP υπολογίζει το ποσό κατ' αναλογία του ποσοστού.
Αναφορά API για δεσμεύσεις μετατροπής συναλλάγματος [REST][NVP]
Επιστροφές χρημάτων
Αν έχετε ρυθμιστεί από το MSO σας για DCC στο American Express PSP, αυτή η ρύθμιση ισχύει για τις παρακάτω επιστροφές.
Επιστροφές ρύθμισης:
CURRENT: Έχει ζητηθεί τιμή συναλλάγματος για την παροχή της πραγματικής ισοτιμίας κατά την ημερομηνία συναλλαγής της επιστροφής.HISTORICAL: Για την επιστροφή θα χρησιμοποιηθεί η ισοτιμία κατά την υποβολή της παραγγελίας.
Αν για την αρχική συναλλαγή προκύψει currencyConversion.uptake=ACCEPTED:
- Η ρύθμιση είναι
CURRENT:- Θα ζητηθεί προσφορά ισοτιμίας για το συγκεκριμένο ποσό επιστροφής. Αυτό θα δημιουργήσει νέο
currencyConversion.requestId. Η νέα τιμή συναλλάγματος θα ισχύσει για την επιστροφή. - Η απόκριση της συναλλαγής είναι
currencyConversion.uptake=ACCEPTED.
- Θα ζητηθεί προσφορά ισοτιμίας για το συγκεκριμένο ποσό επιστροφής. Αυτό θα δημιουργήσει νέο
- Η ρύθμιση είναι
HISTORICAL:- Τα στοιχεία της DCC που παρέχονται για την αρχική συναλλαγή θα χρησιμοποιηθούν για τον υπολογισμό
currencyConversion.payerAmountτης επιστροφής. - Για μερικές επιστροφές ή πλεονάζοντα ποσά επιστροφής, θα παρέχεται το
currencyConversion.payerAmountαπό την αρχική συναλλαγή σε αναλογική βάση ως ποσοστό του ποσού του εμπόρου. Όταν χρησιμοποιείται η αναλογία, χρησιμοποιείται η τυπική στρογγυλοποίηση. - Αν χρησιμοποιήσετε μερικές επιστροφές για πλήρη επιστροφή δεσμευμένου ποσού, η τελευταία μερική επιστροφή θα περιέχει το υπόλοιπο δεσμευμένο ποσό του πληρωτή. Αυτό γίνεται για να ληφθεί υπόψη τυχόν στρογγυλοποίηση στα επί μέρους ποσά. Όπου το συνολικό ποσό που έχει επιστραφεί δεν ισούται με το συνολικό δεσμευμένο ποσό, δεν θα γίνει επικύρωση των ποσών του πληρωτή (π.χ. σε επιπλέον πιστωτικό υπόλοιπο).
- Η απόκριση της συναλλαγής είναι
currencyConversion.uptake=ACCEPTED.
- Τα στοιχεία της DCC που παρέχονται για την αρχική συναλλαγή θα χρησιμοποιηθούν για τον υπολογισμό
Αν για την αρχική συναλλαγή είναι currencyConversion.uptake=DECLINED ή NOT_AVAILABLE ή NOT_REQUIRED:
Αν η επεξεργασία της αρχικής έγκρισης και δέσμευσης γίνει επιτυχώς ως συναλλαγές εκτός DCC και υποβληθεί μετέπειτα αίτημα επιστροφής, τότε ανεξαρτήτως της ρύθμισης εμπόρου σας:
- Δεν θα ζητηθεί τιμή συναλλάγματος.
- Δεν θα δοθούν πεδία
currencyConversionστην απόκριση της συναλλαγής επιστροφής ή τη λειτουργία Retrieve Transaction.
Δοκιμή της ενοποίησης της DCC
Μπορείτε να δοκιμάστε την ενοποίηση της DCC σας χρησιμοποιώντας το δοκιμαστικό προφίλ εμπόρου.