VibeFox Comgate for WooCommerce — Help

Requirements

WordPress: 6.0 or later.

WooCommerce: 7.0 or later, installed and active. The plugin refuses to activate without it.

PHP: 8.0 or later.

HTTPS: your site must be reachable over HTTPS from the internet, so that Comgate can deliver the background notification.

Currency: CZK, EUR, PLN, HUF, USD, GBP, RON, HRK, NOK or SEK. For other currencies and for totals below the Comgate minimum the payment method is hidden. HUF payments are rounded to whole forints, as Comgate requires.

Comgate account: you need the Merchant ID and the secret (password for background communication) of your shop connection in the Comgate client portal, and the notification URL set there (see Configuration). Comgate uses the same Merchant ID and secret for test and live payments.

VibeFox license key: bought on vibefox.net. One key works on one domain.

Installation

1. In WordPress go to Plugins > Add New > Upload Plugin, choose the plugin ZIP file and click Install Now. You can also upload the wcp_comgate_gateway folder to /wp-content/plugins/ by FTP.

2. Click Activate.

3. Open the settings: WooCommerce > Settings > Payments > Comgate > Manage, or click Settings under the plugin name on the Plugins page.

4. Enter your VibeFox license key in the license block at the top of the page and click Activate.

5. Enter the Merchant ID and Secret from the Comgate client portal and set the notification URL there (see Configuration).

6. Turn on Enable / Disable. Keep Test Mode on for a trial payment, then turn it off.

Configuration

All settings are on one page: WooCommerce > Settings > Payments > Comgate. Above the fields the page warns you when Comgate is enabled but the Merchant ID or the secret is missing (the payment method is then hidden at checkout until both are filled in) and when the store currency is not supported. While test mode is on it shows Test mode is on: payments are created as Comgate test payments and no money is charged. Turn it off before going live.

General

Enable / Disable: Enable Comgate Payment Gateway turns the payment method on or off. Default: off.

Title: the payment method name customers see at checkout. Default: Comgate.

Description: the text shown under the payment method at checkout. Default: Pay securely via Comgate — cards, bank transfers, wallets and more. In test mode TEST MODE: no real money is charged. is added to it, or shown alone when the description is empty.

Comgate connection

Take the shop identifier (Merchant ID) and the password (secret) from the Comgate client portal, Integration > shop connection settings. In the same place set the URL for passing the payment result (background notification) to the URL shown in this section. It looks like https://your-site/wc-api/comgate_payment_callback/. Comgate calls it after every payment; the plugin then re-checks the payment with the Comgate status API before it changes the order. Return URLs for the customer are sent with every payment. If the portal asks for return URLs (paid, cancelled, pending) too, use the second URL shown in this section, which looks like https://your-site/wc-api/comgate_payment_return/?id=${id}&refId=${refId}.

Merchant ID: the Comgate e-shop identifier (merchant).

Secret: the password for background communication (secret) of this shop connection.

Test Mode: Create test payments (no money is charged). Comgate uses the same Merchant ID and secret for test and live payments; test payments are marked with test=true. Refunds are always sent in the mode of the original payment. Default: on.

Payment page

Payment Methods: which Comgate payment methods the customer can choose from. Only methods enabled for your shop in Comgate are shown.

Language: the language of the Comgate payment page. Automatic (site language, English as fallback) (default) or one of 26 languages.

Orders

Order Status After Payment: the status set when Comgate confirms the payment. The status is set at once, without a second status change.

Advanced

Debug Log: Log API requests and notifications writes to WooCommerce > Status > Logs, source wcp_comgate_gateway. The secret and personal data are never logged. Errors are always logged. Default: off.

Delete Data on Uninstall: Remove the gateway settings and log files when the plugin is deleted. Orders and their Comgate transaction IDs are always kept. Default: off.

Checkout

The customer chooses the payment method (by default Comgate) and places the order. The plugin creates the payment at Comgate for the order total in the order currency and redirects the customer to the Comgate payment page. The billing e-mail and name are passed to Comgate, and the payment is labelled with the order number. A valid billing e-mail address is required. On the Comgate page the customer pays with one of the methods you allowed.

After paying, the customer returns to your store. The order is marked paid only after Comgate confirms it: the plugin reads the payment from the Comgate status API, both when the background notification arrives and when the customer comes back. If the payment is not confirmed yet, for example a bank transfer on its way, the order received page shows Comgate has not confirmed your payment yet. The order will be updated automatically as soon as the payment is confirmed — please do not pay again. If the order was put on hold, the page shows Your payment is being reviewed. We will contact you if anything else is needed.

If the payment is cancelled or expires, the customer returns to the checkout (or the cart) with The Comgate payment was cancelled or has expired. You can try again or choose another payment method. A customer can pay an unpaid order again, for example from the Pay for order page. The previous attempt is checked first, so a payment that already went through is not charged twice, and it is cancelled at Comgate if it is still open. A late payment of an older attempt still pays an unpaid order.

If Comgate cannot start the payment, the customer sees a short message, for example The Comgate payment could not be started. Please try again or choose another payment method., that Comgate cannot accept this amount or currency, or that the selected Comgate payment method is not available. The technical reason is written to the log.

The payment method works on the classic checkout, on the Checkout block and on the Pay for order page. It is compatible with WooCommerce High-Performance Order Storage (HPOS).

The plugin takes one-time payments on the Comgate page only. It has no recurring payments, subscriptions or saved cards, no embedded Comgate checkout, no Apple Pay or Google Pay buttons on your site (they are available on the Comgate page) and no capture or cancellation of pre-authorizations from WooCommerce. Without the notification the payment status is not polled automatically; it is checked only when the customer returns.

Orders and refunds

Order statuses

Pending payment: the customer was sent to Comgate and has not paid yet, or Comgate reports the payment as pending. The order note shows the created Comgate payment.

Processing or Completed: Comgate reported the payment as PAID with the same amount and currency. The status follows Order Status After Payment. The transaction ID of the order is the Comgate transaction ID; all attempts are kept with the order. Test payments get the note Comgate test payment — no money was charged.

On hold: the paid amount or currency differs from the order, a test payment was confirmed while the shop is in live mode (no money was received), or the payment is only authorized (pre-authorization on your Comgate account). An authorized payment becomes paid automatically when you capture it in the Comgate portal. The order note explains the reason.

Cancelled: the current Comgate payment was cancelled or has expired. If Comgate confirms the payment after WooCommerce cancelled the unpaid order (for example a slow bank transfer), the order is reopened as paid with a note to check stock before shipping.

If Comgate reports another PAID payment for an order that is already paid, the order is not changed again. A note asks you to check it in the Comgate portal and refund the duplicate. A replayed confirmation never reopens a refunded order or an order cancelled after payment.

Refunds

Open the order, click Refund, enter the amount and click Refund via Comgate (the button shows the payment method title). Full and partial refunds are supported. The refund goes to the paid Comgate transaction and is sent in the mode (test or live) of the original payment. Comgate refunds only PAID payments and at most the paid amount; HUF refunds must be whole forints. If Comgate does not accept the refund, WooCommerce shows the error and no refund is recorded. A successful refund is added to the order notes with the amount, the Comgate transaction and the reason.

Refunds made in the Comgate portal are not reported back to the store. If needed, create a manual refund in WooCommerce without Refund via the gateway.

License key

The plugin works with a VibeFox license key from vibefox.net. The license block is at the top of WooCommerce > Settings > Payments > Comgate. Paste the key into License key and click Activate. The block shows the status, for example the date the license is active until and your domain. Use Check now to check the status again, Change key to enter another key and Remove key to remove it from this site. The link Manage licenses and domains in your account opens your vibefox.net account.

One key works on one domain. Removing the key from a site does not free its domain slot. Free the slot in your vibefox.net account.

Without an active key, Comgate is not shown to customers at checkout. If a payment is started anyway, the customer sees This payment method is not available. Please choose another one. Logged-in store managers still see the payment method, marked (unlicensed — visible to admins only), so you can set up and test the plugin before you buy a key. A reminder appears on the Plugins page and on WooCommerce pages. Existing orders are not affected: payments already started are still confirmed, and refunds work.

When a license expires, the plugin keeps working, but updates and support need a renewal. The status is checked again automatically in the background.

Troubleshooting

Comgate does not appear at checkout: check that the license is active, Enable / Disable is on, Merchant ID and Secret are filled in, the order currency is supported and the order total is not below the Comgate minimum (for example 1 CZK, 0.10 EUR or 100 HUF). The settings page shows a warning when the credentials are missing or the currency is not supported.

The payment went through, but the order stays Pending payment: Comgate has not delivered the background notification. Check the URL for passing the payment result in the Comgate portal, that your site is reachable over HTTPS from the internet (no maintenance mode or password protection) and the log (turn on Debug Log). Comgate repeats undelivered notifications; the plugin answers with an error whenever it did not process one, so it will be retried. The order is also confirmed when the customer returns to the store.

Notification answers Invalid merchant or secret: the Merchant ID or secret in the settings does not match the shop connection in the Comgate portal.

Notification answers Gateway not configured: the Merchant ID or secret is empty in the settings. Comgate retries once they are filled in.

Notification answers Order not found, Unknown transaction or Reference mismatch: the notification belongs to a payment that was not created by this store for that order. The order is not changed.

Notification answers Status verification failed, Status verification rejected or Busy, retry later: the Comgate status API could not be reached, rejected the request, or the order was being processed by another request at the same moment. Comgate retries the notification.

The customer sees We could not verify the Comgate payment: the return link did not match the order. If money was charged, the notification still confirms the order. Check the payment in the Comgate portal before the customer pays again.

The customer sees The order total is below the minimum amount accepted by Comgate or A valid billing e-mail address is required for Comgate payments: the order cannot be paid with Comgate as it is.

Order is On hold after payment: read the order note. The paid amount or currency differed, a test payment arrived in live mode, or the payment is only authorized. Check the payment in the Comgate portal and complete or refund the order manually.

Refund fails: read the message. Comgate rejected the refund: the amount exceeds the refundable amount. means the amount is higher than what is left to refund; a payment in another status than PAID cannot be refunded. Comgate could not be reached. The refund was not made — please try again later. means a connection problem.

The license block shows an error: follow the message in the block. For example, if the key is already used on another domain, free a slot in your vibefox.net account and click Check now. If the site address changed, click Check now to activate the key for the new domain. If the license server cannot be reached, the plugin keeps working on the last known status.

Uninstall

Deactivating the plugin keeps all data. To remove it, deactivate and delete it on the Plugins page. The license key and license status of this plugin are always removed. The gateway settings and the log files are removed only if Delete Data on Uninstall was on. Otherwise they stay for a later re-install. Orders and their Comgate data are always kept. Existing orders keep their payment notes and transaction IDs.

Comgate is a trademark of its respective owner. This plugin is not affiliated with or endorsed by Comgate.