Chybové hlášky a jejich řešení

Při zasílání požadavků na platební bránu se můžete setkat s chybovými hláškami, které platební brána vrací. Seznam oznámení najdete v Klientském portálu v sekci Integrace > Testovací logy (uživatelský účet v klientském portálu musí mít roli Tester). Oznámení souhrnně zasíláme e-mailem na adresu, kterou jste zvolili jako kontaktní pro zasílání chybových hlášek. Níže jsou uvedeny nejčastější chybové hlášky a jejich řešení. Podrobný technický popis najdete v dokumentaci API.

Chyby při zakládání platby (volání endpointu create)

Tyto hlášky najdete v testovacím logu v Klientském portálu, neposíláme je e-mailem. Při zakládání platby (nebo volání jiných API metod) je potřeba kontrolovat chybové stavy.

Zakládání plateb z nepovolené IP adresy serveru

Chybová hláška znamená, že e-shop zakládá platby z nepovolené IP adresy serveru. Povolení IP adres můžete provádět sami v Klientském portálu v sekci Integrace > Nastavení obchodů > Propojení obchodu.

IP adresy není nutné definovat jednotlivě, ale mohou být zapsány jako rozsah. Tedy IP adresa následována lomítkem a číslem určujícím počet uzamknutých bitů adresy (tzv. maskou sítě). Například zápis 192.168.1.0/24 povolí IP adresu začínající 192.168.1. s libovolným posledním číslem.

Chybná kombinace parametru země a měny

Chybová hláška znamená, že e-shop zakládá platbu s parametrem country SK a currency CZK, tedy v kombinaci, která není možná. Pro parametr country SK je třeba použít parametr currency EUR, pro parametr country CZ je třeba použít parametr currency CZK.

Chybová hláška znamená, že e-shop zakládá platbu s chybným parametrem country NL. Parametr country se neváže k zemi, z níž nakupuje zákazník, nýbrž k metodám platební brány. Pokud tedy e-shop zakládá platby v měně CZK, parametr country musí být CZ. V případě, že se jedná o platbu v měně EUR, parametr country musí být SK.

Chybný parametr metody

Chybová hláška znamená, že e-shop zakládá platbu s chybným parametrem metody bankovní tlačítko České spořitelny. Správný parametr této metody je BANK_CZ_CS_P. Výčet povolených metod a jejich parametrů najdete v Klientském portálu v sekci Integrace > Nastavení obchodů.

Chybný parametr platby

Zkontrolujte parametry logu platby, který najdete v Klientském portálu v sekci Integrace > Testovací logy. V tomto případě může jít např. o chybně vyplněný parametr merchant (často je v parametru merchant chybně uvedena URL e-shopu místo ID propojení). Může jít také o kombinaci špatného protokolu. Např. v propojení je nastaven SOAP, ale klient posílá HTTP POST nebo opačně. Případně může jít o chybně zadané heslo (parametr secret).

Chybně vyplněný parametr account

Chybová hláška znamená, že e-shop zakládá platbu s vyplněným parametrem account, ačkoli má nastavený pouze jeden výchozí účet pro výplatu. Tento parametr je určen pouze pro případy, kdy chce mít obchodník pro jednu měnu více účtů pro výplatu peněz.

Zakládání ostré transakce v testovacím prostředí

Chybová hláška značí, že e-shop zakládá ostrou transakci ve chvíli, kdy ještě nebyl odsouhlasen k produkčnímu provozu. V tuto chvíli je možné ze strany e-shopu zakládat pouze testovací transakce, které mají parametr test=true. Ostré transakce, které mají parametr test=false, je možné zakládat až po spuštění platební brány do ostrého provozu.

Chyby při předávání stavu do e-shopu

Platební brána v reakci na úhradu nebo zrušení platby zasílá do e-shopu notifikaci o změněném stavu. Při takovém předávání stavů může dojít k několika chybám. Platební brána chyby zaloguje do Klientského portálu do sekce Integrace > Testovací logy (uživatelský účet v klientském portálu musí mít roli Tester). Oznámení souhrnně zasíláme e-mailem na adresu, kterou jste zvolili jako kontaktní pro zasílání chybových hlášek. Níže jsou uvedeny nejčastější chybové hlášky a jejich řešení. Podrobný technický popis najdete v dokumentaci API.

Když se server Comgate snaží předat na server obchodníka stav platby (PAID nebo CANCELLED). 

E-shop neakceptuje předávaný stav platby

Tato chybová hláška nemá vliv na funkčnost platební brány, platba tedy standardně proběhne. Upozorňuje na to, že e-shop neakceptuje správně předání informace o stavu platby.

Pro správnou akceptaci stavu platby je nutné potvrdit převzetí některým z HTTP kódů [200, 201, 202, 204, 205]. Jakýkoliv jiný HTTP kód vyvolá chybu a opětovné předávání informace o stavu platby.

Zároveň je nutné mít správně nastavené návratové URL adresy v propojení obchodu, které najdete v Klientském portálu v sekci Integrace > Nastavení obchodů > Propojení obchodu. 

E-shop neakceptuje předávaný stav platby + vyčerpán limit na přesměrování

Tato chybová hláška nemá vliv na funkčnost platební brány, platba tedy standardně proběhne. Upozorňuje na to, že e-shop neakceptuje správně předání informace o stavu platby.

Informace se předává přes protokol POST. Je pravděpodobné, že server e-shopu provede před vlastní odpovědí ještě přesměrování protokolem GET. To naše strana neakceptuje. Je třeba prověřit, zda přesměrování neprovádí nějaký plugin – typicky v tomto případě bývá problém v SEO pluginu.

Zároveň je nutné mít správně nastavené návratové URL adresy v propojení obchodu, které najdete v Klientském portálu v sekci Integrace > Nastavení obchodů > Propojení obchodu. 

Zároveň zde byl vyčerpán limit na přesměrování plátce na URL, kde má být provedena platba. 

Problém se SSL certifikátem

Chybová hláška znamená problém se SSL certifikátem. Zkontrolujte si platnost SSL certifikátu. Pokud by problém přetrvával, obraťte se na technickou podporu na support@comgate.cz.