Description
Cardcom Payment Gateway
Allows your website to receive payments from your customers, via the WooCommerce plugin at checkout.
Features
This plugin supports various configurations & setups:
- WooCommerce Blocks
- Optional/required Tax-Company ID (TZ/CP) field at checkout, added to the invoice, with localized labels.
- Making credit-card deals & saving as “Payment Method” for returning customers.
- Making Credit-line “delayed” payments (aka “Capture charge”)
- PayPal integration
- Invoicing automatically upon payment (Requires module)
- Support for WooCommerce-Subscriptions
- General-use Tokens for recurring/on-going charges (implementation of CardCom’s API).
References & Manuals
- Support article – settings and configurations
- Support article – receiving API-keys & terminal-number for setup
- General article – contacting Cardcom’s support team
- Contact-Us Page – contact-channels for CardCom’s departments
More Info
See additional technical & general info, see “References & Manuals” above.
To read more about the provider of this service – visit https://www.CardCom.co.il
Installation
Notice
The plugin comes pre-defined with some default settings at setup (once installed & enabled). Please follow the Manuals section for guidance on how to manage these settings before publishing.
If you are unsure of the correct settings or configurations for your setup, advise our support team accordingly.
Minimum Requirements
- WordPress, PHP and WooCommerce versions: see “Requires at least”, “Requires PHP” and “Tested up to” at the top of this page.
- MySQL version 5.6 or later – tested up to 8.0.16
Procedure
-
Install the plugin to your website, either by:
- Search “CardCom” in your WP-control-panel & install this plugin.
- or, download
woo-cardcom-payment-gateway.zipunder “Advanced View“, and directly copying it over to your server’s/wp-content/plugins/directory
-
Then, Activate the plugin through the ‘Plugins’ menu in WordPress.
Next, you need to configure CardCom plugin. -
Access the configuration in the contol-panel via:
- “WooCommerce” menu, “Settings” sub-menu
- “Payments” tab in settings
- “CardCom” link / corresponding “Manage” button
- “WooCommerce” menu, “Settings” sub-menu
-
At the very minimum, you must set the following.
API-UsernameTerminal-Number
-
Leaving the defaults, deals to be made-out to out test-terminal. See also: Relevant support article
-
Regarding other configurations and additional support, please see “REFERENCES & MANUALS” section above.
FAQ
I don’t know what are my “Terminal number” and/or “API-Username”
Go to The CardCom management console, and then navigate to “Settings” menu >> “1. Company setup” >> “4. Manage API-keys”
From there you may copy the keys, or have a copy sent over to your email. See also: Support article
I’m having trouble getting into my CardCom management console
You could reset a user’s password quickly, by going to the “Forgot password” link on the log-in screen.
From there, enter the relevant Username, and their associated SMS/Email. You’ll receive a One-Time password, and then be requested to set a new password.
I’m still having trouble / cannot access management console
If you need to, please call our Support team, to get further assistance –
IL Phone number: +972-3-9436100, see also: Contact-us Page
Checkout page is missing the “CardCom” payment option
Make sure both that the plugin is ENABLED in your WordPress site (goto control-panel), And that it’s ACTIVE for WooCommerce (see step-3 in the Installation guide)
Cannot proceed from checkout to payment page choosing “CardCom” gateway
The most likely explication is either:
- You forgot to set some required parameter at setup
(See: “Terminal number” and “API-Username”) - Some feature is active, which requires a module you’re not subscribed to in your CardCom account.
Example of the second issue may include,
- Setting “Invoice” is active, but your terminal lacks that module.
- You set “Operation” for an action that requires some module:
- All of them require “Low-Profile Page” for the set terminal.
- Ops with “Save Token” / “Capture Charge” – requires “Tokens”.
- Ops “Suspended Deal” (Deprecated) requires that module.
My customers are not receiving their invoice
Make sure your CardCom account has an active module for “Invoices”,
And ensure the “Invoice” and “Send By Email” settings are enabled.
Contact support team for help with of the management console and reports.
Payments are showing-up in reports, but orders stay “Pending payment” or “Cancelled”
This is a potential issue with the site’s hosting service. They may need to allow CardCom’s servers & traffic in the host-firewall.
See relevant info at the END of relevant support article
Everything is great! Where can I leave some comments about it?
Feel free to post about your experiences with CardCom at our public feedback page, or contact us directly over written channels!
Changelog
3.6.0.2
- Fix: when the Cardcom terminal charges the customer a commission for installments, the commission was not added to the WooCommerce order. Capture Charge orders were later charged without the commission, and suspended-deal orders showed a lower total than the deal. The commission is now added to the order as a “Payment commission” fee line (no tax), so the order total, the Capture Charge amount and its invoice include it.
3.6.0.1
- Fix: on Cardcom terminals set to change the payment operation (for example turning every payment into a J5 suspended deal), 3.6.0.0 marked successful payments as failed (“operation mismatch”) and the customer received a failed-order e-mail. Payments are now accepted when Cardcom charged the card, created a suspended deal, or saved the card with a J5 hold, and an order note says what Cardcom did. A result that only saved the card without charging or holding it is still rejected.
- Fix: result codes 0 and 701 (successful J5) are both treated as a successful payment, as before 3.6.0.0.
- Fix: Capture Charge (operation 6) orders that Cardcom charged or held directly are completed instead of staying pending, and are not captured again later. An order whose payment Cardcom turned into a saved card with a J5 hold waits for capture like a Capture Charge order.
- Fix: with Capture Charge (operation 6) the Order Status setting was saved empty; it is now treated as “on-hold”, as shown on the settings screen.
- Fix: the order’s payment details (number of payments, first payment, payment type, total, card type) are visible again in the order Custom Fields box. Card tokens, approval number, card expiry and card-owner details stay hidden.
3.6.0.0
- Security hardening: saved cards can only be used by their logged-in owner; payment results are verified against the order (payment page, operation, amount, currency) before an order is marked paid; subscription card changes require the subscription owner.
- Sensitive data (tokens, ID numbers, e-mail, order keys) is no longer written to logs or error e-mails.
- New minimum requirements: PHP 8.2, WordPress 7.0, WooCommerce 11.1. Admin notices warn about unpatched PHP, WordPress or WooCommerce versions.
- Optional setting to send the API password with token charges.
- Renewal orders now store their Cardcom deal and document numbers, so the Cardcom refund and cancel-document order actions work on renewals (including renewals charged by earlier versions).
- Fix: Capture Charge (operation 6) no longer saves an empty token from a failed first card attempt, so the later capture uses the card that was actually approved. A capture with no stored token now fails with an order note instead of being sent.
- Fix: changing the card on a WooCommerce subscription now keeps it a subscription on sites with HPOS and a persistent object cache, takes it off manual renewal, and charges future renewals to the new card.
Please advise the plugin development log for changes.