DocsFAQ a řešení problémů
Časté otázky a tipy pro řešení problémů
1. Dostávám chybu „Unauthorized"
To obvykle znamená, že odesíláte nesprávný nebo chybně zapsaný API klíč. Zkontrolujte, zda je klíč správný a zda je správně formátován v hlavičce Authorization.
Příklad neúspěšné odpovědi autentizace:
{
"error": "werkzeug.exceptions.Unauthorized",
"message": "The server could not verify that you are authorized to access the URL requested."
}Ujistěte se, že za svým API klíčem uvádíte koncovou dvojtečku při použití Basic Auth (např. YOUR_API_KEY:). Dvojtečka odděluje uživatelské jméno od prázdného hesla.
2. Dostávám chybu „Unsupported payment method"
Každá platební metoda musí být aktivována na vašem účtu, než ji bude možné používat. Pokud se pokusíte použít neaktivní metodu, API vrátí 400 Bad Request:
{
"error": "werkzeug.exceptions.BadRequest",
"message": "The requested payment method is not active for this merchant."
}Kontaktujte svého správce účtu Cost+ nebo povolte platební metodu v administrátorském portálu v sekci Nastavení > Platební metody.
3. Jaká testovací čísla karet mohu použít?
Podívejte se na stránku Testování integrace, kde najdete kompletní seznam testovacích čísel karet včetně karet simulujících úspěšné i neúspěšné transakce.
4. Jak se řeší opakování webhook notifikací?
Pokud váš webhook endpoint neodpoví stavovým kódem 2xx, Cost+ zopakuje doručení:
- Až 10 pokusů, s odstupem 2 minuty.
- První pokus má timeout 4 sekundy.
- Následné pokusy mají timeout 10 sekund.
Pokud všech 10 pokusů selže, webhooková událost je označena jako neúspěšná a nebude znovu opakována. Ujistěte se, že váš endpoint odpovídá rychle a vrací stavový kód 200.
Kompletní informace o konfiguraci webhooků a formátech payloadu najdete v průvodci Webhooky.