CartModules: Comgate Payments
Integrate Comgate Payments, Czech Republic's versatile payment gateway, directly into your CS-Cart or Multi-Vendor store. This addon provides a secure hosted payment page flow so your customers can pay using bank cards, Czech bank transfers, and mobile payments.
Key Features
- Hosted Payment Page — Customers are redirected to Comgate's secure payment page, keeping your store PCI SAQ A compliant with no direct card handling.
- Comgate REST API — Connects to Comgate's payment API using Merchant ID and Secret authentication for reliable payment processing.
- Server-to-Server Callbacks — Reliable order status updates via Comgate's callback system, even if the customer closes their browser.
- Multiple Payment Methods — Accept cards, Czech bank transfers, and mobile payments through a single integration.
- Multi-Currency Support — Accept payments in Czech Koruna (CZK) and Euro (EUR).
- Sandbox Mode — Test the full payment flow using Comgate's test mode before going live.
- Automatic Language Detection — The payment page language is set automatically based on the customer's store language.
- Configurable Status Mapping — Map Comgate payment outcomes (Paid, Cancelled, Pending) to your preferred CS-Cart order statuses.
- Idempotent Processing — Duplicate callbacks are handled safely without re-processing orders.
- Secure Logging — All API interactions are logged with sensitive credentials (Secret) automatically stripped.
- Clean Uninstall — Removes all database entries on uninstallation with no residual data.
How It Works
- Customer selects Comgate at checkout and places the order.
- The addon creates a payment via the Comgate REST API.
- Customer is redirected to Comgate's hosted payment page to complete payment.
- Comgate sends a server-to-server callback to your store confirming the payment result.
- The order status is updated automatically and the customer sees the confirmation page.
Configuration
| Setting | Description |
|---|---|
| Payment Mode | Switch between Test (Sandbox) and Live (Production) environments. |
| Merchant ID | Your Comgate Merchant ID from the Comgate merchant dashboard. |
| Secret | Your Comgate Secret key from the Comgate merchant dashboard. |
| Currency | Select the transaction currency: CZK or EUR. |
| Status Mapping | Choose which CS-Cart order status to assign for paid, cancelled, and pending payments. |
Requirements
- CS-Cart 4.x (Ultimate or Multi-Vendor edition)
- PHP 7.1 or later
- Active Comgate merchant account (comgate.cz)
- SSL certificate installed on your store
Supported Countries
Comgate Payments is a Czech Republic-based payment gateway, ideal for Czech and Slovak e-commerce stores. It supports CZK and EUR currencies for cross-border transactions within Central Europe.
Installation
- Go to Add-ons > Manage add-ons, click Manual installation, and upload the addon zip
- Activate the addon and enter the license key
- Create a new payment method under Administration > Payment methods.
- Select Comgate Payments as the processor and enter your Merchant ID and Secret.
- Save, activate, and start accepting payments.
Compatibility
| Platform | Supported |
|---|---|
| CS-Cart Ultimate | Yes |
| CS-Cart Multi-Vendor | Yes |
| PHP 7.1+ | Yes |
| PHP 8.x | Yes |
