DocsFAQ i rozwiązywanie problemów
Najczęstsze pytania i wskazówki dotyczące rozwiązywania problemów
1. Otrzymuję błąd „Unauthorized"
Zwykle oznacza to, że przesyłasz nieprawidłowy lub błędnie wpisany klucz API. Sprawdź dokładnie, czy Twój klucz jest poprawny i prawidłowo sformatowany w nagłówku Authorization.
Przykład odpowiedzi z nieudanym uwierzytelnieniem:
{
"error": "werkzeug.exceptions.Unauthorized",
"message": "The server could not verify that you are authorized to access the URL requested."
}Upewnij się, że dodajesz końcowy dwukropek po kluczu API podczas korzystania z Basic Auth (np. YOUR_API_KEY:). Dwukropek oddziela nazwę użytkownika od pustego hasła.
2. Otrzymuję błąd „Unsupported payment method"
Każda metoda płatności musi być aktywowana na Twoim koncie, zanim będzie mogła być użyta. Jeśli spróbujesz użyć nieaktywnej metody, API zwróci 400 Bad Request:
{
"error": "werkzeug.exceptions.BadRequest",
"message": "The requested payment method is not active for this merchant."
}Skontaktuj się z menedżerem konta Cost+ lub włącz metodę płatności w panelu administracyjnym w sekcji Ustawienia > Metody płatności.
3. Jakich testowych numerów kart mogę użyć?
Zobacz stronę Testowanie integracji, na której znajdziesz pełną listę testowych numerów kart, w tym kart symulujących udane i nieudane transakcje.
4. Jak obsługiwane są ponowienia webhooków?
Jeśli Twój punkt końcowy webhooka nie odpowie kodem statusu 2xx, Cost+ ponowi dostarczenie:
- Do 10 ponowień, w odstępach 2 minut.
- Pierwsza próba ma limit czasu 4 sekundy.
- Kolejne ponowienia mają limit czasu 10 sekund.
Jeśli wszystkie 10 ponowień zakończy się niepowodzeniem, zdarzenie webhooka zostanie oznaczone jako nieudane i nie będzie ponawiane. Upewnij się, że Twój punkt końcowy odpowiada szybko i zwraca kod statusu 200.
Szczegółowe informacje na temat konfiguracji webhooków i formatów danych znajdziesz w przewodniku Webhooki.