DocsΔοκιμή της Ενσωμάτωσής σας
Ρυθμίστε το δοκιμαστικό περιβάλλον και χρησιμοποιήστε δοκιμαστικά διαπιστευτήρια
Πριν ενεργοποιήσετε τη ζωντανή λειτουργία, χρησιμοποιήστε μια ιστοσελίδα sandbox της Cost+ για να επαληθεύσετε ότι η ενσωμάτωσή σας λειτουργεί σωστά. Δεν υπάρχει ξεχωριστό URL sandbox — χρησιμοποιείτε το ίδιο production API endpoint (https://api.costplus.online/v1) με ένα κλειδί API από μια ιστοσελίδα sandbox.
Λήψη του Δοκιμαστικού Κλειδιού API
- Συνδεθείτε στην Πύλη Εμπόρου
- Μεταβείτε στα Websites
- Δημιουργήστε μια νέα ιστοσελίδα και επιλέξτε Sandbox ως τύπο, ή επιλέξτε μια υπάρχουσα ιστοσελίδα sandbox
- Κάντε κλικ στο Integration για να βρείτε το κλειδί API σας
- Χρησιμοποιήστε αυτό το κλειδί API στην ενσωμάτωσή σας — όλες οι συναλλαγές θα προσομοιώνονται
Η λειτουργία sandbox έναντι production καθορίζεται αποκλειστικά από τον τύπο ιστοσελίδας στην Πύλη Εμπόρου, όχι από το URL του API. Το κλειδί API μιας ιστοσελίδας sandbox επεξεργάζεται προσομοιωμένες συναλλαγές· το κλειδί API μιας ιστοσελίδας production επεξεργάζεται πραγματικές πληρωμές. Και τα δύο χρησιμοποιούν το ίδιο API endpoint.
Αριθμοί Δοκιμαστικών Καρτών
Χρησιμοποιήστε τους παρακάτω αριθμούς καρτών για να προσομοιώσετε διάφορα σενάρια πληρωμής. Μη χρησιμοποιείτε πραγματικούς αριθμούς καρτών σε δοκιμαστική λειτουργία.
| Αριθμός Κάρτας | CVV | Μάρκα | Αποτέλεσμα |
|---|---|---|---|
4111111111111111 | οποιοδήποτε | Visa | Επιτυχία |
5544330000000037 | οποιοδήποτε | Mastercard | Επιτυχία |
4462030000000000 | οποιοδήποτε | Visa | Επιτυχία |
4111111111111105 | οποιοδήποτε | Visa | Do Not Honor |
4111111111111143 | οποιοδήποτε | Visa | Stolen Card |
4111111111111151 | οποιοδήποτε | Visa | Insufficient Funds |
Χρησιμοποιήστε οποιαδήποτε μελλοντική ημερομηνία λήξης και οποιοδήποτε 3ψήφιο CVC.
Οι αριθμοί δοκιμαστικών καρτών λειτουργούν μόνο σε λειτουργία sandbox. Η υποβολή τους σε κλειδί API ιστοσελίδας production θα οδηγήσει σε απορριφθείσα συναλλαγή.
Κωδικοί Σφαλμάτων
Όταν μια συναλλαγή αποτυγχάνει, το API επιστρέφει έναν από τους παρακάτω κωδικούς σφαλμάτων στο πεδίο reason της συναλλαγής:
| Κωδικός Σφάλματος | Περιγραφή |
|---|---|
ERROR_CARD_AUTHENTICATION_FAILURE | Η αυθεντικοποίηση 3DS δεν ολοκληρώθηκε εγκαίρως· η πληρωμή ακυρώθηκε |
ERROR_CARD_CVV_NOT_VALID | Το CVV είναι σωστά μορφοποιημένο αλλά μη έγκυρο |
ERROR_CARD_INFORMATION_NOT_VALID | Τα στοιχεία κάρτας είναι σωστά μορφοποιημένα αλλά μη έγκυρα |
ERROR_CARD_NOT_SUPPORTED_FOR_ECOMMERCE | Η συναλλαγή δεν υποστηρίζεται για eCommerce |
ERROR_CARD_NOT_VALID | Το ID κάρτας δεν είναι έγκυρο |
ERROR_CARD_TYPE_DISABLED | Ο τύπος κάρτας είναι απενεργοποιημένος |
ERROR_TRANSACTION_FAILED | Η συναλλαγή κάρτας απέτυχε |
ERROR_TRANSACTION_REJECTED_BY_CARD_PROCESSOR | Απορρίφθηκε από τον επεξεργαστή (περιλαμβάνει αριθμητικό κωδικό Visa/MC) |
ERROR_TRANSACTION_TYPE_NOT_ALLOWED_BY_SELLER | Ο τύπος συναλλαγής δεν επιτρέπεται από τον πωλητή |
ERROR_TRANSACTION_TYPE_NOT_SUPPORTED | Δεν υποστηρίζεται από το δίκτυο κάρτας |
INVALID_CARD_CVV | Το CVV δεν αναγνωρίζεται |
INVALID_CARD_NUMBER | Ο αριθμός κάρτας δεν αναγνωρίζεται |
Συνηθισμένα Σφάλματα Επικύρωσης API
Αυτά τα σφάλματα επιστρέφονται ως 400 Bad Request όταν το ίδιο το αίτημα API δεν είναι έγκυρο:
| Σφάλμα | Περιγραφή |
|---|---|
| Unknown payment method | Δώσατε λανθασμένο όνομα μεθόδου πληρωμής |
| No permissions for payment method | Το κλειδί API (project) δεν έχει δικαιώματα για τη συγκεκριμένη μέθοδο πληρωμής |
| Payment method not enabled | Η μέθοδος πληρωμής δεν έχει ενεργοποιηθεί για το κλειδί API (project) σας |
| Payment method not supported | Το κλειδί API (project) δεν έχει τη σωστή κατάσταση για τη χρήση της συγκεκριμένης μεθόδου πληρωμής |
Αν λαμβάνετε "Payment method not enabled" ή "No permissions", ελέγξτε τη ρύθμιση μεθόδου πληρωμής στην Πύλη Εμπόρου στις ρυθμίσεις ιστοσελίδας σας.