Frequently Asked Questions (FAQ)
Where can I find API credentials?
You can find your API credentials in the client portal under Services → Checkouts: open the checkout (payment gateway), on the Shop connection tab click the connection, and in its detail you will find the Merchant ID and Secret fields.
What is the API login and what is the API password?
The login is the shop connection identifier (in most cases a six-digit number), and the password belongs to this identifier. Both values are listed in the client portal in the shop connection detail (Services → Checkouts → checkout → Shop connection) as Merchant ID and Secret.
What is background payment creation vs. redirect payment creation and why is background creation better?
Background payment creation is used for secure and guaranteed payment creation with parameters that correspond exactly to the e-shop order. The payer cannot influence values such as the price and must pay the full amount. Redirect payment creation, on the other hand, is typically used for donations, where the payer can freely change the payment amount. In the vast majority of cases, we therefore recommend background payment creation (calling the Comgate API directly from the e-shop).
Why is it not recommended to start an implementation using SOAP?
SOAP is supported only for historical reasons and is no longer being developed, so it is not recommended to start a new implementation using it.
How do I set up the IP whitelist?
The Comgate API is protected using an IP whitelist. For each e-shop, we register IP addresses from which communication with our API is allowed. You can add allowed IP addresses in the client portal in the shop connection edit form (Services → Checkouts → checkout → Shop connection → Edit, the Allowed IP addresses list). Contact your hosting provider to obtain all outgoing IP addresses from which your servers may communicate. Hosting providers often publish lists of IP addresses on their websites. If your server uses a dynamic IP address, you can disable IP whitelist checking in the client portal using the Allow all IPs option. In this case, pay maximum attention to securing the communication password.
What should be set in the PENDING, PAID, and CANCELLED URLs in the shop connection?
You must fill in the URLs if you are using HTTP POST or REST (not required for SOAP). The first three URLs are used for redirecting the user, while the last URL is used for background result delivery. Without properly configured URLs, the e-shop may not receive the transaction result. If you do not fill in the pending URL, the payment gateway will not display the “Return to e-shop” button. PENDING, PAID, and CANCELLED URLs are endpoints in the e-shop to which the payer is redirected from the payment gateway (e.g. after successful payment). The result delivery URL is used for communication between our API and the e-shop (passing the payment result to the e-shop).
How do I set the URLs?
You must fill in the URLs if you are using HTTP POST or REST (not required for SOAP). The first three URLs are used for redirecting the user, while the last URL is used for background result delivery. Without properly configured URLs, the e-shop may not receive the transaction result. If you do not fill in the pending URL, the payment gateway will not display the “Return to e-shop” button.
How do I enable redirect payment creation?
Redirect payment creation must first be enabled in the shop connection in the client portal (Services → Checkouts → checkout → Shop connection → Edit, the Payment creating method field). There is no need to configure an IP whitelist and no password needs to be sent when creating the request. This type of payment creation is not preferred and is intended only for simple applications such as donation payments.
Where can I find PHP examples?
PHP examples can be found on the API documentation page.
What does the test parameter mean?
The test parameter determines whether the payment is only a simulation or a real payment (e.g. by payment card).
It is typically used before deployment to production to test the payment gateway functionality for a specific payment.
How do I set an email address for error notifications?
In the client portal in the checkout detail (Services → Checkouts, Detail tab, Edit button), it is recommended to set the E-mail for e‑shop connection errors. Multiple addresses can be separated by semicolons. The developer will then receive API errors (e.g. invalid currency and payment method combinations) directly by email.
Where can I find the list of allowed payment methods in the API?
We recommend downloading the available methods dynamically when generating the payer’s cart. They can be obtained via an API call – see this documentation.
How can an organization administrator create API credentials for a developer?
An organization administrator can create credentials for a developer in the client portal under Settings → Users using the New user button.
Is an email address required when creating a transaction? What instructions are sent to the payer by email?
An email address is required for every payment—either provided by the e-shop when creating the payment or entered later by the payer on the payment gateway. To simplify the payment process, we recommend providing the email directly from the e-shop. The payer receives an email with a link to view the payment status and can also retry a previously unsuccessful payment using that link.
How can the payment status be verified?
The only secure way to verify the payment status is by calling the appropriate API method – see this documentation.