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
Error [1308] - Specified payment method BANK_CZ_CS, country CZ and currency CZK is not enabled for you! Only following countries, methods and currencies are enabled for you: CZ:BANK_CZ_AB:CZK, CZ:BANK_CZ_CSOB:CZK, CZ:BANK_CZ_CS_P:CZK, CZ:BANK_CZ_CTB:CZK, CZ:BANK_CZ_EB:CZK, CZ:BANK_CZ_FB:CZK, CZ:BANK_CZ_GE:CZK, CZ:BANK_CZ_KB:CZK, CZ:BANK_CZ_MB_P:CZK, CZ:BANK_CZ_OTHER:CZK, CZ:BANK_CZ_PS:CZK, CZ:BANK_CZ_RB:CZK, CZ:BANK_CZ_UC:CZK, CZ:BANK_CZ_VB:CZK, CZ:BANK_CZ_ZB:CZK
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
Error [1400] - Unauthorized access
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).
merchant=142797&test=false&country=CZ&price=381200&curr=CZK&label=2000214&refId=2000214&payerId=&vatPL=&cat=&method=ALL&account=&email=grlodders%40outlook.com&phone=620107837&name=&lang=&prepareOnly=true&secret=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&preauth=false&initRecurring=false&eetReport=&eetData=
Chybne vyplnený parameter account
Error [1311] - Invalid bank account identifier 000000000/2010
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
The payment status report has not been accepted by merchant server.
Protocol: HTTP POST.
Merchant server URL: (https://www.gaea.cz/comgatenotificationhandler)
Invalid HTTP response status code: 500. The valid value is 200.
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
The payment status report has not been accepted by merchant server.
Protocol: HTTP POST.
Merchant server URL: (https://vytvorsipotisk.cz/?comgate=notify)
Error in cURL request: Maximum (5) redirects followed
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
Error in cURL request: SSL certificate problem: unable to get local issuer certificate
Error in cURL request: SSL certificate problem: certificate has expired
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.