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.