Chybové hlášky a ich riešenie

Pri zasielaní požiadaviek na platobnú bránu sa môžete stretnúť s chybovými hláškami, ktoré platobná brána vráti späť. Zoznam oznámení nájdete v Klientskom portáli v sekcii Integrácia > Testovacie logy (používateľský účet v klientskom portáli musí mať rolu Tester). Oznámenia súhrnne zasielame e-mailom na adresu, ktorú ste zvolili ako kontaktnú pre zasielanie chybových hlášok. Nižšie sú uvedené najčastejšie chybové hlášky a ich riešenie. Podrobný technický popis nájdete v dokumentácii API.

Chyby pri zakladaní platby (volanie endpointu create)

Tieto hlášky nájdete v testovacom logu v Klientskom portáli, neposielame ich e-mailom. Pri zakladaní platby (alebo volaní iných API metód) je potrebné kontrolovať chybové stavy. 

Zakladanie platieb z nepovolenej IP adresy serveru

Chybová hláška znamená, že e-shop zakladá platby z nepovolenej IP adresy serveru. Povolenie IP adries môžete vykonávať sami v Klientskom portáli v sekcii Integrácia > Nastavenie obchodov > Prepojenie obchodu.

IP adresy nie je nutné definovať jednotlivo, ale môžu byť zapísané ako rozsah. Teda IP adresa nasledovaná lomítkom a číslom určujúcim počet uzamknutých bitov adresy (tzv. maskou siete). Napríklad zápis 192.168.1.0/24 povolí IP adresu začínajúcu 192.168.1. s ľubovoľným posledným číslom.

Chybná kombinácia parametru krajiny a meny

Chybová hláška znamená, že e-shop zakladá platbu s parametrom country SK a currency CZK, teda v kombinácii, ktorá nie je možná. Pre parameter country SK je potrebné použiť parameter currency EUR, pre parameter country CZ je potrebné použiť parameter currency CZK. 

Chybová hláška znamená, že e-shop zakladá platbu s chybným parametrom country NL. Parameter country sa neviaže ku krajine, z ktorej zákazník nakupuje, ale k metódam platobnej brány. Pokiaľ teda e-shop zakladá platby v mene CZK, parameter country musí byť CZ. V prípade, že sa jedná o platbu v mene EUR, parameter country musí byť SK.

Chybný parameter metódy

Chybová hláška znamená, že e-shop zakladá platbu s chybným parametrom metódy bankové tlačidlo Českej sporiteľne. Správny parameter tejto metódy je BANK_CZ_CS_P. Zoznam povolených metód a ich parametrov nájdete v Klientskom portáli v sekcii Integrácia > Nastavenie obchodov.

Chybný parameter platby

Skontrolujte parametre logu platby, ktorý nájdete v Klientskom portáli v sekcii Integrácia > Testovacie logy. V tomto prípade môže ísť napr. o chybne vyplnený parameter merchant (často je v parametri merchant chybne uvedená URL e-shopu namiesto ID prepojenia). Môže ísť tiež o kombináciu nesprávneho protokolu. Napr. v prepojení je nastavený SOAP, ale klient posiela HTTP POST alebo naopak. Prípadne môže ísť o chybne zadané heslo (parameter secret).

Chybne vyplnený parameter account

Chybová hláška znamená, že e-shop zakladá platbu s vyplneným parametrom account, aj keď má nastavený len jeden predvolený účet pre výplatu. Tento parameter je určený len pre prípady, kedy chce mať obchodník pre jednu menu viac účtov pre výplatu peňazí.

Zakladanie ostrej transakcie v testovacom prostredí

Chybová hláška znamená, že e-shop zakladá ostrú transakciu vo chvíli, kedy ešte nebola odsúhlasená k produkčnej prevádzke. V túto chvíľu je možné zo strany e-shopu zakladať len testovacie transakcie, ktoré majú parameter test=true. Ostré transakcie, ktoré majú parameter test=false, je možné zakladať až po spustení platobnej brány do ostrej prevádzky.

Chyby pri prenose stavu do e-shopu

Platobná brána v reakcii na úhradu alebo zrušenie platby zasiela do e-shopu notifikáciu o zmenenom stave. Pri takom prenose stavov môže dôjsť k niekoľkým chybám. Platobná brána chyby zaloguje do Klientskeho portálu do sekcie Integrácia > Testovacie logy (používateľský účet v klientskom portáli musí mať rolu Tester). Oznámenia súhrnne zasielame e-mailom na adresu, ktorú ste zvolili ako kontaktnú pre zasielanie chybových hlášok. Nižšie sú uvedené najčastejšie chybové hlášky a ich riešenie. Podrobný technický popis nájdete v dokumentácii API.

Keď sa server Comgate snaží odovzdať na server obchodníka stav platby (PAID alebo CANCELLED). 

E-shop neakceptuje odovzdaný stav platby

Táto chybová hláška nemá vplyv na funkčnosť platobnej brány, platba teda štandardne prebehne. Upozorňuje na to, že e-shop neakceptuje správne odovzdanie informácie o stave platby.

Pre správnu akceptáciu stavu platby je nutné potvrdiť prevzatie HTTP kódom 200. Akýkoľvek iný HTTP kód vyvolá chybu a opätovné odovzdávanie informácie o stave platby.

Zároveň je nutné mať správne nastavené návratové URL adresy v prepojení obchodu, ktoré nájdete v Klientskom portáli v sekcii Integrácia > Nastavenie obchodov > Prepojenie obchodu. 

E-shop neakceptuje odovzdaný stav platby + vyčerpaný limit na presmerovanie

Táto chybová hláška nemá vplyv na funkčnosť platobnej brány, platba teda štandardne prebehne. Upozorňuje na to, že e-shop neakceptuje správne odovzdanie informácie o stave platby.

Informácia sa odovzdáva cez protokol POST. Je pravdepodobné, že server e-shopu vykoná pred vlastnou odpoveďou ešte presmerovanie protokolom GET. To naša strana neakceptuje. Je potrebné preveriť, či presmerovanie nevykonáva nejaký plugin – typicky v tomto prípade býva problém v SEO pluginu.

Zároveň je nutné mať správne nastavené návratové URL adresy v prepojení obchodu, ktoré nájdete v Klientskom portáli v sekcii Integrácia > Nastavenie obchodov > Prepojenie obchodu. 

Zároveň tu bol vyčerpaný limit na presmerovanie platcu na URL, kde má byť vykonaná platba. 

Problém so SSL certifikátom

Chybová hláška znamená problém so SSL certifikátom. Skontrolujte si platnosť SSL certifikátu. Pokiaľ by problém pretrvával, obráťte sa na technickú podporu na support@comgate.cz.