Error Messages on the Payment Gateway and Their Solutions
When sending requests to the payment gateway, you may encounter error messages returned by the gateway.
A list of notifications can be found in the Client Portal under Integration > Test Logs (the user account in the Client Portal must have the Tester role).
Notifications are also sent in summary form by email to the address you selected as the contact email for error notifications.
Below are the most common error messages and their solutions.
A detailed technical description can be found in the API documentation.
Errors during payment creation (calling the create endpoint)
These messages can be found in the test log in the Client Portal and are not sent by email.
When creating a payment (or calling other API methods), it is necessary to check for error states.
Payment creation from an unauthorized server IP address
Error [1400] - Access from unauthorized location [194.212.79.116]!
This error message means that the e-shop is creating payments from a server IP address that is not allowed.
Allowed IP addresses can be configured by the merchant in the Client Portal under Integration > Shop settings > Shop connection.
IP addresses do not need to be defined individually; they can be entered as a range.
That is, an IP address followed by a slash and a number defining the number of locked bits (the network mask).
For example, the entry 192.168.1.0/24 allows all IP addresses starting with 192.168.1. regardless of the last number.
The range of IP addresses used by the Comgate system can be found in the API documentation.
Invalid combination of country and currency parameters
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
This error message means that the e-shop is creating a payment with country = SK and currency = CZK, which is an invalid combination.
For country = SK, the currency must be EUR.
For country = CZ, the currency must be CZK.
Error [1317] - Invalid country of payment [NL]
This error message means that the e-shop is creating a payment with an invalid country parameter (NL).
The country parameter does not represent the customer’s country, but the country of the payment gateway methods.
If payments are created in CZK, the country parameter must be CZ.
If the payment currency is EUR, the country parameter must be SK.
Invalid payment method parameter
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
This error message means that the e-shop is creating a payment with an invalid method parameter for the Česká spořitelna bank button.
The correct parameter for this method is BANK_CZ_CS_P.
A list of allowed methods and their parameters can be found in the Client Portal under Integration > Shop settings.
Invalid payment parameter
Error [1400] - Unauthorized access
Check the payment log parameters in the Client Portal under Integration > Test Logs.
This error can be caused, for example, by an incorrectly filled merchant parameter (often the e-shop URL is mistakenly entered instead of the shop connection ID).
It may also be caused by an incorrect protocol combination—for example, SOAP is configured in the shop connection, but the client sends HTTP POST requests, or vice versa.
Another possible cause is an incorrectly entered password (secret parameter).
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=
Incorrectly filled account parameter
Error [1311] - Invalid bank account identifier 000000000/2010
This error message means that the e-shop is creating a payment with the account parameter filled in, even though only one default payout account is configured.
This parameter is intended only for cases where the merchant wants to have multiple payout accounts for one currency.
Creating a production transaction in the test environment
Error [1308] - Production environment is not enabled for you, it is enabled testing environment only
This error message indicates that the e-shop is creating a live (production) transaction before production approval has been granted.
At this stage, only test transactions with the parameter test=true can be created.
Live transactions with test=false can only be created after the payment gateway is launched into production.
Errors during payment status delivery to the e-shop
In response to payment completion or cancellation, the payment gateway sends a notification about the changed payment status to the e-shop.
Errors may occur during this process.
The payment gateway logs these errors in the Client Portal under Integration > Test Logs (the user account must have the Tester role).
Notifications are also sent by email to the configured error contact address.
Below are the most common error messages and their solutions.
A detailed technical description can be found in the API documentation.
When the Comgate server attempts to deliver the payment status (PAID or CANCELLED) to the merchant’s server:
The e-shop does not accept the delivered payment status
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].
This error message does not affect the functionality of the payment gateway—the payment is processed normally.
It indicates that the e-shop does not correctly accept the payment status notification.
To properly accept the payment status, the e-shop must confirm receipt using one of the HTTP status codes [200, 201, 202, 204, 205].
Any other HTTP status code triggers an error and causes the payment status notification to be resent.
It is also necessary to have correctly configured return URLs in the shop connection, available in the Client Portal under Integration > Shop settings > Shop connection.
The e-shop does not accept the payment status + redirect limit exceeded
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
This error message does not affect the functionality of the payment gateway—the payment is processed normally.
It indicates that the e-shop does not correctly accept the payment status notification.
The information is sent via the POST protocol.
It is likely that the e-shop server performs a GET redirect before sending its response, which is not accepted by our system.
Check whether a plugin is causing the redirect—this issue is typically caused by an SEO plugin.
It is also necessary to have correctly configured return URLs in the shop connection in the Client Portal under Integration > Shop settings > Shop connection.
In this case, the redirect limit for redirecting the payer to the payment URL has also been exceeded.
SSL certificate problem
Error in cURL request: SSL certificate problem: unable to get local issuer certificate
Error in cURL request: SSL certificate problem: certificate has expired
This error message indicates a problem with the SSL certificate.
Check the validity of your SSL certificate.
If the problem persists, contact technical support at support@comgate.cz.