DocsTestování integrace
Nastavte si testovací prostředí a použijte testovací přihlašovací údaje
Před spuštěním do produkce použijte sandbox web Cost+ k ověření, že vaše integrace funguje správně. Neexistuje žádná samostatná sandbox URL — používáte stejný produkční API endpoint (https://api.costplus.online/v1) s API klíčem ze sandbox webu.
Získání testovacího API klíče
- Přihlaste se do obchodního portálu
- Přejděte na Weby
- Vytvořte nový web a vyberte Sandbox jako typ, nebo vyberte existující sandbox web
- Klikněte na Integrace, kde najdete svůj API klíč
- Použijte tento API klíč ve své integraci — všechny transakce budou simulované
Sandbox vs. produkční režim je určen výhradně typem webu v obchodním portálu, nikoli URL API. API klíč sandbox webu zpracovává simulované transakce; API klíč produkčního webu zpracovává skutečné platby. Oba používají stejný API endpoint.
Testovací čísla karet
Použijte níže uvedená čísla karet k simulaci různých platebních scénářů. Nepoužívejte skutečná čísla karet v testovacím režimu.
| Číslo karty | CVV | Značka | Výsledek |
|---|---|---|---|
4111111111111111 | libovolné | Visa | Úspěch |
5544330000000037 | libovolné | Mastercard | Úspěch |
4462030000000000 | libovolné | Visa | Úspěch |
4111111111111105 | libovolné | Visa | Do Not Honor |
4111111111111143 | libovolné | Visa | Stolen Card |
4111111111111151 | libovolné | Visa | Insufficient Funds |
Použijte libovolné budoucí datum platnosti a libovolný 3místný CVC.
Testovací čísla karet fungují pouze v sandbox režimu. Odeslání těchto čísel s API klíčem produkčního webu povede k zamítnutí transakce.
Chybové kódy
Když transakce selže, API vrátí jeden z následujících chybových kódů v poli reason transakce:
| Chybový kód | Popis |
|---|---|
ERROR_CARD_AUTHENTICATION_FAILURE | 3DS autentizace nebyla dokončena včas; platba zrušena |
ERROR_CARD_CVV_NOT_VALID | CVV správně formátováno, ale není platné |
ERROR_CARD_INFORMATION_NOT_VALID | Údaje o kartě správně formátovány, ale nejsou platné |
ERROR_CARD_NOT_SUPPORTED_FOR_ECOMMERCE | Transakce není podporována pro eCommerce |
ERROR_CARD_NOT_VALID | ID karty není platné |
ERROR_CARD_TYPE_DISABLED | Typ karty je zakázán |
ERROR_TRANSACTION_FAILED | Kartová transakce selhala |
ERROR_TRANSACTION_REJECTED_BY_CARD_PROCESSOR | Zamítnuto procesorem (včetně numerického kódu Visa/MC) |
ERROR_TRANSACTION_TYPE_NOT_ALLOWED_BY_SELLER | Typ transakce není prodejcem povolen |
ERROR_TRANSACTION_TYPE_NOT_SUPPORTED | Není podporováno kartovou sítí |
INVALID_CARD_CVV | CVV nerozpoznáno |
INVALID_CARD_NUMBER | Číslo karty nerozpoznáno |
Běžné validační chyby API
Tyto chyby jsou vráceny jako 400 Bad Request, když je samotný API požadavek neplatný:
| Chyba | Popis |
|---|---|
| Unknown payment method | Uvedli jste nesprávný název platební metody |
| No permissions for payment method | Váš API klíč (projekt) nemá oprávnění pro uvedenou platební metodu |
| Payment method not enabled | Platební metoda nebyla povolena pro váš API klíč (projekt) |
| Payment method not supported | Váš API klíč (projekt) nemá správný stav pro použití uvedené platební metody |
Pokud obdržíte chybu „Payment method not enabled" nebo „No permissions", zkontrolujte konfiguraci platební metody v obchodním portálu v nastavení vašeho webu.