DocsTestowanie integracji
Skonfiguruj środowisko testowe i użyj danych testowych
Przed uruchomieniem produkcyjnym użyj testowej strony Cost+, aby sprawdzić, czy Twoja integracja działa poprawnie. Nie ma osobnego adresu URL dla środowiska testowego — używasz tego samego produkcyjnego punktu końcowego API (https://api.costplus.online/v1) z kluczem API ze strony testowej.
Uzyskanie testowego klucza API
- Zaloguj się do portalu sprzedawcy
- Przejdź do sekcji Strony
- Utwórz nową stronę i wybierz Sandbox jako typ lub wybierz istniejącą stronę testową
- Kliknij Integracja, aby znaleźć swój klucz API
- Użyj tego klucza API w swojej integracji — wszystkie transakcje będą symulowane
Tryb testowy a produkcyjny jest określany wyłącznie przez typ strony w portalu sprzedawcy, a nie przez adres URL API. Klucz API strony testowej przetwarza symulowane transakcje; klucz API strony produkcyjnej przetwarza prawdziwe płatności. Oba używają tego samego punktu końcowego API.
Testowe numery kart
Użyj poniższych numerów kart, aby symulować różne scenariusze płatności. Nie używaj prawdziwych numerów kart w trybie testowym.
| Numer karty | CVV | Marka | Wynik |
|---|---|---|---|
4111111111111111 | dowolny | Visa | Sukces |
5544330000000037 | dowolny | Mastercard | Sukces |
4462030000000000 | dowolny | Visa | Sukces |
4111111111111105 | dowolny | Visa | Do Not Honor |
4111111111111143 | dowolny | Visa | Stolen Card |
4111111111111151 | dowolny | Visa | Insufficient Funds |
Użyj dowolnej przyszłej daty ważności i dowolnego 3-cyfrowego CVC.
Testowe numery kart działają tylko w trybie testowym. Przesłanie ich z kluczem API strony produkcyjnej spowoduje odrzucenie transakcji.
Kody błędów
Gdy transakcja się nie powiedzie, API zwraca jeden z poniższych kodów błędów w polu reason transakcji:
| Kod błędu | Opis |
|---|---|
ERROR_CARD_AUTHENTICATION_FAILURE | Uwierzytelnianie 3DS nie zostało ukończone na czas; płatność anulowana |
ERROR_CARD_CVV_NOT_VALID | CVV poprawnie sformatowane, ale nieprawidłowe |
ERROR_CARD_INFORMATION_NOT_VALID | Dane karty poprawnie sformatowane, ale nieprawidłowe |
ERROR_CARD_NOT_SUPPORTED_FOR_ECOMMERCE | Transakcja nieobsługiwana dla e-commerce |
ERROR_CARD_NOT_VALID | Identyfikator karty jest nieprawidłowy |
ERROR_CARD_TYPE_DISABLED | Typ karty jest wyłączony |
ERROR_TRANSACTION_FAILED | Transakcja kartą nie powiodła się |
ERROR_TRANSACTION_REJECTED_BY_CARD_PROCESSOR | Odrzucona przez procesor (zawiera kod numeryczny Visa/MC) |
ERROR_TRANSACTION_TYPE_NOT_ALLOWED_BY_SELLER | Typ transakcji niedozwolony przez sprzedawcę |
ERROR_TRANSACTION_TYPE_NOT_SUPPORTED | Nieobsługiwane przez sieć kartową |
INVALID_CARD_CVV | CVV nierozpoznane |
INVALID_CARD_NUMBER | Numer karty nierozpoznany |
Typowe błędy walidacji API
Te błędy są zwracane jako 400 Bad Request, gdy samo żądanie API jest nieprawidłowe:
| Błąd | Opis |
|---|---|
| Unknown payment method | Podano nieprawidłową nazwę metody płatności |
| No permissions for payment method | Twój klucz API (projekt) nie ma uprawnień do określonej metody płatności |
| Payment method not enabled | Metoda płatności nie została włączona dla Twojego klucza API (projektu) |
| Payment method not supported | Twój klucz API (projekt) nie ma odpowiedniego statusu do korzystania z określonej metody płatności |
Jeśli otrzymujesz komunikat „Payment method not enabled" lub „No permissions", sprawdź konfigurację metody płatności w portalu sprzedawcy w ustawieniach swojej strony.