Chybové hlásenia na bráne a ich riešenie
Pri odosielaní požiadaviek na platobnú bránu sa môžete stretnúť s chybovými hláseniami, ktoré platobná brána vracia. 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 zasielame aj súhrnne e-mailom na adresu, ktorú ste zvolili ako kontaktnú pre zasielanie chybových hlásení. Nižšie sú uvedené najčastejšie chybové hlásenia a ich riešenia. Podrobný technický popis nájdete v API dokumentácii.
Chyby pri zakladaní platby (volanie endpointu create)
Tieto hlásenia 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 servera
Error [1400] - Access from unauthorized location [194.212.79.116]!
Toto chybové hlásenie znamená, že e-shop zakladá platby z nepovolenej IP adresy servera. Povolené IP adresy si môžete nastaviť sami v Klientskom portáli v sekcii Integrácia > Nastavenia obchodov > Prepojenie obchodu.
IP adresy nie je potrebné definovať jednotlivo, môžu byť zapísané ako rozsah – teda IP adresa nasledovaná lomkou a číslom určujúcim počet uzamknutých bitov adresy (tzv. sieťová maska).
Napríklad zápis 192.168.1.0/24 povolí všetky IP adresy začínajúce 192.168.1. s ľubovoľným posledným číslom.
Rozsah IP adries používaných systémom Comgate nájdete v API dokumentácii.
Nesprávna kombinácia parametra krajiny a meny
Error [1308] - No payment method is enabled for you in SK country and CZK currency! Only following countries, methods and currencies are enabled for you: CZ:BANK_CZ_CS_P: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_RB:CZK, CZ:BANK_CZ_UC:CZK, CZ:BANK_CZ_VB:CZK, SK:BANK_SK_CSOB:EUR, SK:BANK_SK_FB:EUR, SK:BANK_SK_OTHER:EUR, SK:BANK_SK_PB:EUR, SK:BANK_SK_SP:EUR, SK:BANK_SK_TB:EUR, SK:BANK_SK_UC:EUR, SK:BANK_SK_VUB:EUR
Toto chybové hlásenie znamená, že e-shop zakladá platbu s parametrami country = SK a currency = CZK, čo je neplatná kombinácia.
Pre country = SK je potrebné použiť currency = EUR.
Pre country = CZ je potrebné použiť currency = CZK.
Error [1317] - Invalid country of payment [NL]
Toto chybové hlásenie znamená, že e-shop zakladá platbu s nesprávnym parametrom country = NL.
Parameter country sa nevzťahuje na krajinu zákazníka, ale na krajinu platobných metód platobnej brány.
Ak e-shop zakladá platby v mene CZK, parameter country musí byť CZ.
Ak ide o platbu v mene EUR, parameter country musí byť SK.
Nesprávny parameter platobnej 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
Toto chybové hlásenie znamená, že e-shop zakladá platbu s nesprávnym parametrom metódy pre bankové tlačidlo České spořitelny.
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 > Nastavenia obchodov.
Nesprávny parameter platby
Error [1400] - Unauthorized access
Skontrolujte parametre v logu platby, ktorý nájdete v Klientskom portáli v sekcii Integrácia > Testovacie logy.
V tomto prípade môže ísť napríklad o nesprávne vyplnený parameter merchant (často je do parametra merchant omylom uvedená URL e-shopu namiesto ID prepojenia).
Môže ísť aj o nesprávnu kombináciu protokolov – napríklad v prepojení je nastavený SOAP, ale klient posiela HTTP POST, alebo naopak.
Ďalšou možnou príčinou je nesprávne 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=
Nesprávne vyplnený parameter account
Error [1311] - Invalid bank account identifier 000000000/2010
Toto chybové hlásenie znamená, že e-shop zakladá platbu s vyplneným parametrom account, hoci má nastavený iba jeden predvolený účet pre výplatu.
Tento parameter je určený len pre prípady, keď chce obchodník používať viac účtov pre jednu menu.
Zakladanie produkčnej transakcie v testovacom prostredí
Error [1308] - Production environment is not enabled for you, it is enabled testing environment only
Toto chybové hlásenie znamená, že e-shop zakladá produkčnú (ostrú) transakciu v čase, keď ešte nebol schválený pre produkčnú prevádzku.
V tomto štádiu je možné zakladať iba testovacie transakcie s parametrom test=true.
Produkčné transakcie s parametrom test=false je možné zakladať až po spustení platobnej brány do ostrej prevádzky.
Chyby pri odovzdávaní stavu do e-shopu
Platobná brána v reakcii na úhradu alebo zrušenie platby odosiela do e-shopu notifikáciu o zmene stavu. Pri tomto procese môže dôjsť k viacerým chybám.
Platobná brána chyby zaloguje v Klientskom portáli v sekcii Integrácia > Testovacie logy (pou žívateľ musí mať rolu Tester) a zároveň ich súhrnne odosiela e-mailom na nastavenú kontaktnú adresu.
Keď sa server Comgate pokúša odovzdať serveru obchodníka stav platby (PAID alebo CANCELLED):
E-shop neakceptuje odovzdávaný 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 one of [200, 201, 202, 204, 205].
Toto chybové hlásenie nemá vplyv na funkčnosť platobnej brány – platba prebehne štandardne.
Upozorňuje však na to, že e-shop správne neakceptuje informáciu o stave platby.
Na správnu akceptáciu je potrebné potvrdiť prevzatie jedným z HTTP kódov [200, 201, 202, 204, 205].
Akýkoľvek iný HTTP kód spôsobí chybu a opakované odosielanie informácie o stave platby.
Zároveň je potrebné mať správne nastavené návratové URL adresy v prepojení obchodu v Klientskom portáli v sekcii Integrácia > Nastavenia obchodov > Prepojenie obchodu.
E-shop neakceptuje stav platby + vyčerpaný limit presmerovaní
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
Toto chybové hlásenie nemá vplyv na funkčnosť platobnej brány – platba prebehne štandardne.
Znamená, že e-shop správne neakceptuje odovzdanie stavu platby.
Informácia je odosielaná protokolom POST. Je pravdepodobné, že server e-shopu pred vlastnou odpoveďou vykoná presmerovanie pomocou GET, čo naša strana neakceptuje.
Skontrolujte, či presmerovanie nespôsobuje niektorý plugin – v týchto prípadoch ide často o SEO plugin.
Zároveň je potrebné mať správne nastavené návratové URL adresy v prepojení obchodu v Klientskom portáli v sekcii Integrácia > Nastavenia obchodov > Prepojenie obchodu.
V tomto prípade bol zároveň vyčerpaný limit presmerovaní platcu na URL, kde má byť platba spracovaná.
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
Toto chybové hlásenie znamená problém so SSL certifikátom. Skontrolujte platnosť SSL certifikátu.
Ak problém pretrváva, kontaktujte technickú podporu na support@comgate.cz.