Αντιμετώπιση προβλημάτων και συχνές ερωτήσεις
Αυτή η ενότητα περιέχει προτάσεις και λύσεις για προβλήματα που μπορεί να προκύψουν με την ενοποίησή σας.
Η λειτουργία πρόσθετου τέλους στο Mastercard Gateway επιτρέπει σε έναν έμπορο να εφαρμόζει επιπλέον χρέωση σε μια συναλλαγή με βάση τις ακόλουθες παραμέτρους:
- Σημείο εισόδου πύλης, όπως Hosted Checkout ή API.
- Τρόπος πληρωμής όπως Mastercard, Visa ή American Express.
- Τρόπος χρηματοδότησης όπως Πιστωτική ή Χρεωστική.
- Νόμισμα
Ναι, μπορείτε να διαμορφώσετε τους Κανόνες φιλτραρίσματος IP χώρας στη Merchant Administration. Ο πάροχος υπηρεσιών πληρωμής που χρησιμοποιείτε μπορεί να διαμορφώσει κανόνες για εσάς στο Merchant Manager, επιπλέον των κανόνων που ισχύουν για όλους τους εμπόρους. Αυτό θα σας επιτρέψει να απορρίψετε ή να ελέγξετε συναλλαγές που προέρχονται από διευθύνσεις IP που σχετίζονται με χώρες υψηλού κινδύνου.
Επιστροφές χρημάτων μπορούν να πραγματοποιηθούν μόνο όταν μια μεταφορά χρημάτων ολοκληρωθεί είτε μέσω Pay είτε μέσω Capture.
Ακύρωση μπορεί να πραγματοποιηθεί μόνο για συναλλαγές που δεν έχουν σταλεί στην τράπεζα από την τράπεζα εμπόρου για διεκπεραίωση στο τέλος της ημέρας.
Ναι, μπορείτε να ορίσετε μια επαναλαμβανόμενη πληρωμή με μεταβλητό ποσό, για παράδειγμα, πληρωμή λογαριασμών εκ των υστέρων. Πρέπει να ενημερώσετε την τιμή της παραμέτρου amountVariability σύμφωνα με τις απαιτήσεις. Για περισσότερες πληροφορίες, βλ. Συναλλαγές με διαπιστευτήρια στο αρχείο.
Η κύρια διαφορά μεταξύ των δύο εκδόσεων SDK είναι η εξής:
| SDK έκδοση 1 | SDK έκδοση 2 |
|---|---|
| Δεν υπάρχει εγγενής εμπειρία εντός εφαρμογής | Εγγενής εμπειρία εντός εφαρμογής, χωρίς ανακατευθύνσεις |
| Ροή challenge με ανακατευθύνσεις | Υποστηρίζονται πολλαπλές ροές πρόκλησης, όπως OTP, απλή και πολλαπλή επιλογή, βασισμένες σε απαντήσεις. |
| Ροή challenge εκδότη μέσω του web browser σε κινητή συσκευή | Εξυπνότερη ροή frictionless που οδηγεί σε λιγότερες προκλήσεις για τον πληρωτή |
Αυτό εξαρτάται από το χρηματοπιστωτικό ίδρυμα που εξέδωσε την κάρτα στον πληρωτή. Κάθε εκδότης κάρτας ορίζει την περίοδο λήξης της έγκρισης για την οποία κρατεί τα χρήματα στον λογαριασμό του πληρωτή, ενώ περιμένει την άφιξη της συναλλαγής δέσμευσης. Γενικά, χρειάζονται 5-8 ημέρες διεκπεραίωσης πριν την απαλοιφή της έγκρισης από τον λογαριασμό του πληρωτή και η πρόσβαση στα χρήματα ξαναδίνεται στον πληρωτή.
Μπορείτε να χρησιμοποιήσετε τα ακόλουθα πεδία για να αποτυπώσετε σφάλματα επικύρωσης:
Το πεδίο error.explanation [REST][NVP] θα περιέχει κάποιο κείμενο σφάλματος αναγνώσιμο από ανθρώπους, που θα δίνει περισσότερες πληροφορίες σχετικά με το σφάλμα, όπως ελάχιστο ή αναμενόμενο μήκος κ.λπ. Μην αναλύετε αυτές τις πληροφορίες, καθώς δεν είναι εγγυημένη η μορφή αυτού του κειμένου.
Η ενοποίηση με το Payment Client και το Virtual Payment Client επιστρέφει κωδικούς απόκρισης αντί για τις απαριθμήσεις που επιστρέφονται για το Web-Services API; Οι πίνακες παρακάτω δείχνουν την αντιστοίχιση μεταξύ των δύο τύπων αποκρίσεων που επιστρέφονται από το American Express PSP.
| Payment Client/Virtual Payment Client | Web-Services API | ||
|---|---|---|---|
| Κωδικός απόκρισης | Περιγραφή | response.gatewayCode |
Περιγραφή |
| 0 | Επιτυχία συναλλαγής | APPROVED |
Η συναλλαγή εγκρίθηκε |
| 1 | Δεν ήταν δυνατή η διεκπεραίωση της συναλλαγής | UNSPECIFIED_FAILURE |
Δεν ήταν δυνατή η διεκπεραίωση της συναλλαγής |
| 2 | Η συναλλαγή απορρίφθηκε - Επικοινωνήστε με την εκδίδουσα τράπεζα | DECLINED |
Η πράξη που ζητήθηκε δεν ήταν επιτυχής. Για παράδειγμα, μια πληρωμή απορρίφθηκε από τον εκδότη ή η ταυτοποίηση πληρωτή δεν μπόρεσε να ολοκληρωθεί με επιτυχία. |
| 3 | Η συναλλαγή απορρίφθηκε - Καμία απόκριση από την τράπεζα | TIMED_OUT |
Λήξη χρονικού ορίου απόκρισης |
| 4 | Η συναλλαγή απορρίφθηκε - Ληγμένη κάρτα | EXPIRED_CARD |
Η συναλλαγή απορρίφθηκε λόγω ληγμένης κάρτας |
| 5 | Η συναλλαγή απορρίφθηκε - Ανεπαρκής πίστωση | INSUFFICIENT_FUNDS |
Η συναλλαγή απορρίφθηκε λόγω ανεπαρκών χρημάτων |
| 6 | Η συναλλαγή απορρίφθηκε - Σφάλμα συστήματος τράπεζας | ACQUIRER_SYSTEM_ERROR | Παρουσιάστηκε σφάλμα στο σύστημα της τράπεζας εμπόρου κατά τη διεκπεραίωση αυτής της συναλλαγής. |
| 7 | Σφάλμα επεξεργασίας διακομιστή πληρωμών. Τυπικά οφείλεται στην εισαγωγή μη έγκυρων δεδομένων, όπως αριθμό πιστωτικής κάρτας. Μπορούν επίσης να συμβούν σφάλματα διεκπεραίωσης. | SYSTEM_ERROR |
Παρουσιάστηκε εσωτερικό σφάλμα συστήματος της συναλλαγής |
| 8 | Η συναλλαγή απορρίφθηκε - Ο τύπος συναλλαγής δεν υποστηρίζεται | NOT_SUPPORTED |
Ο τύπος συναλλαγής δεν υποστηρίζεται |
| 9 | Η τράπεζα απέρριψε τη συναλλαγή (μην επικοινωνήσετε με την τράπεζα) | DECLINED_DO_NOT_CONTACT |
Η συναλλαγή απορρίφθηκε - μην επικοινωνήσετε με τον εκδότη |
| A | Η συναλλαγή ματαιώθηκε | ABORTED |
Η συναλλαγή ματαιώθηκε από τον κάτοχο κάρτας |
| B | Η συναλλαγή αποκλείστηκε - Επιστρέφεται όταν: -το επίπεδο ασφαλείας επαλήθευσης έχει τιμή "07", - Ο έμπορος έχει ενεργοποιήσει το κλείδωμα 3D-Secure, -το συνολικό αποτέλεσμα της εκτίμησης κινδύνου επιστρέφει "Απόρριψη" ή "Απόρριψη συστήματος" |
BLOCKED |
Η συναλλαγή έχει αποκλειστεί λόγω κανόνων αποκλεισμού κινδύνου ή 3D Secure |
| C | Η συναλλαγή ακυρώθηκε | CANCELLED |
Η συναλλαγή ακυρώθηκε από τον κάτοχο κάρτας |
| D | Μεταχρονολογημένη συναλλαγή | DEFERRED_TRANSACTION_RECEIVED |
Ελήφθη μεταχρονολογημένη συναλλαγή και αναμένεται διεκπεραίωση |
| E | Η συναλλαγή απορρίφθηκε - Απευθυνθείτε στον εκδότη της κάρτας | REFERRED |
Η συναλλαγή απορρίφθηκε - απευθυνθείτε στον |
| F | Η ταυτοποίηση 3D Secure απέτυχε | AUTHENTICATION_FAILED |
Η ταυτοποίηση 3D Secure απέτυχε |
| I | Ο κωδικός ασφαλείας κάρτας απέτυχε | INVALID_CSC |
Μη έγκυρος κωδικός ασφαλείας κάρτας |
| L | Η συναλλαγή αγοράς κλειδώθηκε. Αυτό δείχνει ότι πραγματοποιείται άλλη συναλλαγή χρησιμοποιώντας τον ίδιο αριθμό συναλλαγής αγοράς. | LOCK_FAILURE |
Η παραγγελία κλειδώθηκε - μια άλλη συναλλαγή βρίσκεται σε εξέλιξη για αυτήν την παραγγελία |
| M | Η συναλλαγή υποβλήθηκε (η συναλλαγή κατευθύνθηκε στην τράπεζα εμπόρου, αλλά ο διακομιστής πληρωμών δεν την έχει λάβει ακόμα για να την ολοκληρώσει) | SUBMITTED |
Η συναλλαγή υποβλήθηκε - δεν έχει ληφθεί ακόμα απόκριση |
| N | Ο κάτοχος κάρτας δεν έχει εγγραφεί στο 3DSecure (μόνο ταυτοποίηση) | NOT_ENROLLED_3D_SECURE |
Μη κάτοχος κάρτας δεν έχει εγγραφεί στο 3DSecure |
| P | Συναλλαγή σε εκκρεμότητα | PENDING |
Συναλλαγή σε εκκρεμότητα |
| R | Υπέρβαση ορίου επαναλήψεων, δεν ήταν δυνατή η διεκπεραίωση της συναλλαγής | EXCEEDED_RETRY_LIMIT |
Υπέρβαση ορίου επαναλήψεων |
| S | Η συναλλαγή απορρίφθηκε - Διπλότυπο πακέτο | DUPLICATE_BATCH |
Η συναλλαγή απορρίφθηκε λόγω διπλότυπου πακέτου |
| Τ | Η επαλήθευση διεύθυνσης απέτυχε | DECLINED_AVS |
Η συναλλαγή απορρίφθηκε λόγω επαλήθευσης διεύθυνσης |
| U | Ο κωδικός ασφαλείας κάρτας απέτυχε | DECLINED_CSC |
Η συναλλαγή απορρίφθηκε λόγω κωδικού ασφαλείας κάρτας |
| V | Η επαλήθευση διεύθυνσης και ο κωδικός ασφαλείας κάρτας απέτυχαν | DECLINED_AVS_CSC |
Η συναλλαγή απορρίφθηκε λόγω επαλήθευσης διεύθυνσης και κωδικού ασφαλείας κάρτας |
| W | Η συναλλαγή απορρίφθηκε - Το πλάνο πληρωμών δεν υποστηρίζεται | DECLINED_PAYMENT_PLAN |
Η συναλλαγή απορρίφθηκε επειδή το πλάνο πληρωμών δεν υποστηρίζεται |
| X | Εγκεκριμένη τακτοποίηση σε εκκρεμότητα - Εγκρίθηκε από σύστημα τακτοποίησης πακέτων, αλλά αναμένονται περαιτέρω λεπτομέρειες από την τράπεζα εμπόρου. | APPROVED_PENDING_SETTLEMENT |
Η συναλλαγή εγκρίθηκε - εκκρεμεί η τακτοποίηση πακέτου |
| ? | Άγνωστη απόκριση | UNKNOWN |
Άγνωστη απόκριση |
| Payment Client/Virtual Payment Client | Web-Services API | ||
|---|---|---|---|
| Κωδικός απόκρισης | Περιγραφή | response.cardholderVerification.avs.gatewayCode |
Περιγραφή |
| X | Ακριβής αντιστοίχιση – διεύθυνση και ΤΚ 9 ψηφίων | ADDRESS_ZIP_MATCH |
Έγινε αντιστοίχιση διεύθυνσης οδού και ΤΚ |
| Y | Ακριβής αντιστοίχιση – διεύθυνση και ΤΚ 5 ψηφίων | ||
| D | Έγινε αντιστοίχιση διεύθυνσης οδού και ΤΚ για διεθνή συναλλαγή. | ||
| M | Έγινε αντιστοίχιση διεύθυνσης οδού και ΤΚ για διεθνή συναλλαγή. | ||
| F | Αντιστοίχιση διεύθυνσης οδού και ΤΚ. Ισχύει μόνο για το ΗΒ. | ||
| W | Έγινε αντιστοίχιση ΤΚ 9 ψηφίων, δεν έγινε αντιστοίχιση διεύθυνσης | ZIP_MATCH |
Έγινε αντιστοίχιση ΤΚ. Δεν έγινε αντιστοίχιση διεύθυνσης |
| P | Έγινε αντιστοίχιση των ταχυδρομικών κωδίκων για διεθνή συναλλαγή, αλλά η διεύθυνση δεν επαληθεύτηκε λόγω μη συμβατών μορφών. | ||
| Z | Έγινε αντιστοίχιση ΤΚ 5 ψηφίων, δεν έγινε αντιστοίχιση διεύθυνσης | ||
| A | Αντιστοίχιση διεύθυνσης μόνο | ADDRESS_MATCH |
Έγινε αντιστοίχιση διεύθυνσης |
| B | Έγινε αντιστοίχιση διεύθυνσης οδού για διεθνή συναλλαγή. Ο ταχυδρομικός κώδικας δεν επαληθεύτηκε λόγω μη συμβατών μορφών. | ||
| S | Η υπηρεσία δεν υποστηρίζεται επί του παρόντος. | SERVICE_NOT_SUPPORTED |
Η υπηρεσία δεν υποστηρίζεται επί του παρόντος από τράπεζα εμπόρου ή έμπορο |
| G | Διεθνής συναλλαγή, μη διαθέσιμες πληροφορίες διεύθυνσης. | NOT_VERIFIED |
Δεν ήταν δυνατή η επαλήθευση του AVS για διεθνή συναλλαγή |
| C | Δεν ήταν δυνατή η επαλήθευση της διεύθυνσης οδού και του ταχυδρομικού κώδικα για διεθνή συναλλαγή λόγω μη συμβατών μορφών. | ||
| I | Visa μόνο. Οι πληροφορίες διεύθυνσης δεν επαληθεύτηκαν για διεθνή συναλλαγή. | ||
| R | Το σύστημα του εκδότη δεν είναι διαθέσιμο. Προσπαθήστε ξανά. | SERVICE_NOT_AVAILABLE_RETRY |
Το σύστημα του εκδότη δεν είναι διαθέσιμο. Μπορείτε να επιχειρήσετε επανάληψη της προσπάθειας. |
| U | Η διεύθυνση δεν είναι διαθέσιμη, δεν υπάρχουν δεδομένα από τον εκδότη. | NOT_AVAILABLE |
Δεν υπάρχουν διαθέσιμα δεδομένα από τον εκδότη ή τα δεδομένα AVS δεν υποστηρίζονται για τη συναλλαγή |
| E | Δεν είναι ταχυδρομική/τηλεφωνική παραγγελία. | ||
| N | Δεν έγινε αντιστοίχιση της διεύθυνσης και του ΤΚ. | NO_MATCH |
Δεν υπάρχει αντιστοίχιση |
| 0 (Μηδέν) | Δεν ζητήθηκε AVS. (Χρησιμοποιείται από τη VisaII.) | NOT_REQUESTED |
Δεν ζητήθηκε AVS |
| K | Αντιστοιχεί μόνο το όνομα του κατόχου κάρτας. | NAME_MATCH |
Έγινε αντιστοίχιση του ονόματος κατόχου κάρτας |
| O | Αντιστοιχεί το όνομα και η διεύθυνση του κατόχου κάρτας | NAME_ADDRESS_MATCH |
Έγινε αντιστοίχιση του ονόματος και της διεύθυνσης του κατόχου κάρτας |
| L | Αντιστοιχεί το όνομα και ο ΤΚ του κατόχου κάρτας | NAME_ZIP_MATCH |
Έγινε αντιστοίχιση του ονόματος και του ΤΚ του κατόχου κάρτας |
| Payment Client/Virtual Payment Client | Web-Services API | ||
|---|---|---|---|
| Κωδικός απόκρισης | Περιγραφή | response.cardSecurityCode.gatewayCode |
Περιγραφή |
| M | Έγκυρος ή αντιστοιχισμένος CSC | MATCHED |
Έγκυρος ή αντιστοιχισμένος |
| S | Ο έμπορος υποδεικνύει ότι δεν υπάρχει CSC στην κάρτα | NOT_PRESENT |
Ο έμπορος υπέδειξε ότι δεν υπάρχει CSC στην κάρτα |
| P | Δεν έγινε διεκπεραίωση του CSC | NOT_PROCESSED |
Δεν έγινε διεκπεραίωση |
| U | Ο εκδότης της κάρτας δεν είναι εγγεγραμμένος ή/και πιστοποιημένος | NOT_SUPPPORTED |
Ο εκδότης της κάρτας δεν είναι εγγεγραμμένος ή/και πιστοποιημένος |
| N | Ο κωδικός δεν είναι έγκυρος ή δεν αντιστοιχεί | NO_MATCH |
Δεν είναι έγκυρος ή δεν αντιστοιχεί. |
Ναι, είναι ασφαλές να υποβάλετε ξανά ένα αίτημα με τις ίδιες ακριβώς λεπτομέρειες επειδή η πύλη υποστηρίζει ταυτοδύναμες πράξεις. Οι ταυτοδύναμες πράξεις παράγουν το ίδιο αποτέλεσμα όταν γίνεται επανειλημμένα επίκλησή τους. Αν η πύλη έχει ήδη λάβει το αίτημά σας, θα επιστρέψει την αρχική απόκριση. Διαφορετικά θα επεξεργαστεί το αίτημα και θα επιστρέψει την απόκριση.
Συνήθως, μπορείτε να αντιστοιχίσετε τα αιτήματα με τις αποκρίσεις χρησιμοποιώντας τα πεδία order.id και transaction.id καθώς αυτά παρέχονται στα αιτήματα και επιστρέφονται στις αποκρίσεις. Ωστόσο, αν η εφαρμογή σας δεν υποστηρίζει μοντέλο σύγχρονης ενοποίησης ή αν η προέλευση και ο προορισμός ενός αιτήματος διαφέρουν, μπορείτε να χρησιμοποιήσετε το πεδίο correlationId για να προσδιορίσετε το αίτημα και την αντίστοιχη απόκρισή του. Το correlationId είναι ένα παροδικό αναγνωριστικό, η τιμή του οποίου δεν παραμένει στην πύλη και επιστρέφεται όπως δόθηκε στην απόκριση στο αίτημα. Μπορείτε να χρησιμοποιήσετε το correlationId με όλα τα αιτήματα Web-Services API.
No merchant acquirer link για μια τράπεζα εμπόρου για την οποία έχουν διαμορφωθεί οι ρυθμίσεις μου;Επικοινωνήστε με τον your payment service provider για να βεβαιωθείτε ότι ο σύνδεσμος στην τράπεζα εμπόρου στην πύλη έχει διαμορφωθεί για τους απαιτούμενους συνδυασμούς τύπου κάρτας και νομίσματος.
Το Merchant Administration είναι ένα περιβάλλον εργασίας στο web και επιτρέπει στους εμπόρους να βλέπουν και να διαχειρίζονται εύκολα τις παραγγελίες τους. Οι έμποροι μπορούν να αναζητήσουν και να προβάλουν τις λεπτομέρειες παραγγελίας/συναλλαγής, να λάβουν αναφορές CSV, να ελέγξουν τα αποτελέσματα 3-D Secure, να ορίσουν ελέγχους κινδύνου, να δημιουργήσουν παραγγελίες χειροκίνητα, να διαχειριστούν τις επιστροφές χρημάτων και πολλά άλλα. Ανατρέξτε στον οδηγό χρήσης του Merchant Administration για περισσότερες λεπτομέρειες.
Οι έμποροι πρέπει να ενσωματωθούν στην πύλη και το προφίλ εμπόρου τους να έχει διαμορφωθεί με επιτυχία για να έχουν πρόσβαση στο Merchant Administration.
Ο εκδότης ή το δίκτυο της κάρτας μπορεί να παρέχει πρόσθετες πληροφορίες με τη μορφή ενός κωδικού συμβουλής εμπόρου, ο οποίος θα σας βοηθήσει να κατανοήσετε τον λόγο απόρριψης της συναλλαγής. Όταν μια συναλλαγή απορρίπτεται λόγω ανεπαρκών κεφαλαίων, ο κωδικός συμβουλής μπορεί να προτείνει ένα χρονικό πλαίσιο επανάληψης δοκιμής στους εμπόρους κατά το οποίο μια έγκριση ταυτοποίησης ενδέχεται να είναι επιτυχής.
Ο παρακάτω πίνακας παρέχει μια περιγραφή των διαφόρων κωδικών συμβουλών εμπόρου που επιστράφηκαν από τα προγράμματα.
| Κωδικός συμβουλής εμπόρου | Σύσταση προγράμματος |
|---|---|
| 01 | Πληροφορίες νέου λογαριασμού διαθέσιμες |
| 02 | Δεν είναι δυνατή η έγκριση αυτή τη στιγμή, δοκιμάστε ξανά αργότερα |
| 03 | Μην δοκιμάσετε ξανά |
| 04 | Οι απαιτήσεις token δεν πληρούνται για αυτόν τον τύπο token |
| 05 | Η διαπραγματευόμενη τιμή δεν εγκρίθηκε |
| 21 | Ακύρωση πληρωμής |
| 22 | Ο έμπορος δεν πληροί τις προϋποθέσεις για τον κωδικό προϊόντος |
| 24 | Δοκιμάστε ξανά μετά από 1 ώρα |
| 25 | Δοκιμάστε ξανά μετά από 24 ώρες |
| 26 | Δοκιμάστε ξανά μετά από 2 ημέρες |
| 27 | Δοκιμάστε ξανά μετά από 4 ημέρες |
| 28 | Δοκιμάστε ξανά μετά από 6 ημέρες |
| 29 | Δοκιμάστε ξανά μετά από 8 ημέρες |
| 30 | Δοκιμάστε ξανά μετά από 10 ημέρες |
| R0 | Εντολή διακοπής πληρωμής |
| R1 | Εντολή ανάκλησης έγκρισης |
| R3 | Εντολή ανάκλησης όλων των εγκρίσεων |