Forums / Addon Payment Modules / helcim payments by mxWorks.cc

helcim payments by mxWorks.cc

Views: 6,171

Results 1 to 20 of 26
4 Apr 2025, 4:46 AM
#1
carlwhat avatar

carlwhat

zennedOut

Join Date:
Nov 2005
Location:
los angeles
Posts:
2,972
Plugin Contributions:
8

helcim payments by mxWorks.cc

this will be the new support forum for a new payment module from helcim by mxWorks.cc.

this module reduces PCI scope while allowing customers to use card on file transactions.

it is ONLY available for US and Canadian merchants.

please post all support questions here.

module should be available once approved by the ZC admins.

it is a totally encapsulated plugin; although it does require the latest version of admin -> orders.php from the zen-cart github repo (although that file is included in the download).

it has only been tested on v2.1.0; with plans to fully support it going forward (assuming there is enough interest in its use).

a testing API token is provided for store owners to test on their development/staging severs without the need to create a new account. although creating your own account will give you a more complete experience.

author of square Webpay, now with Apple Pay and Google Pay.
mXworks
donations: venmo or paypal accepted.
premium consistent excellent support. available for hire.

4 Apr 2025, 10:11 AM
#2
swguy avatar

swguy

Administrator

Join Date:
Feb 2006
Location:
Tampa Bay, Florida
Posts:
10,725
Plugin Contributions:
56

Re: helcim payments by mxWorks.cc

Very exciting! Thanks for this contribution; it has been approved.

For clarification: Does this module have less PCI risk than Square Webpay, or is it the same?
This might be a new area for documentation.

That Software Guy. My Store: Zen Cart Support
Available for hire - See my ad in Services
Plugin Moderator, Documentation Curator, Chief Cook and Bottle-Washer.
Do you benefit from Zen Cart? Then please support the project.

4 Apr 2025, 2:09 PM
#3
carlwhat avatar

carlwhat

zennedOut

Join Date:
Nov 2005
Location:
los angeles
Posts:
2,972
Plugin Contributions:
8

Re: helcim payments by mxWorks.cc

swguy:

Very exciting! Thanks for this contribution; it has been approved.

For clarification: Does this module have less PCI risk than Square Webpay, or is it the same?
This might be a new area for documentation.

pci is all about scope, and reducing the number of systems that touch sensitive cardholder data.

with regards to the methodology of the payment processor providing an iframe where the consumer then enters their cc information there and it not touching the zc store, both payment modules operate in the same way.

as to which implementation has less risk, i am truly not in a position to say.

i am a fan of both implementations as they both minimize scope more than some of the other payment modules at which i have looked.

author of square Webpay, now with Apple Pay and Google Pay.
mXworks
donations: venmo or paypal accepted.
premium consistent excellent support. available for hire.

4 Apr 2025, 2:58 PM
#4
carlwhat avatar

carlwhat

zennedOut

Join Date:
Nov 2005
Location:
los angeles
Posts:
2,972
Plugin Contributions:
8

Re: helcim payments by mxWorks.cc

minor bug on install found.

v1.0.1 submitted.

author of square Webpay, now with Apple Pay and Google Pay.
mXworks
donations: venmo or paypal accepted.
premium consistent excellent support. available for hire.

4 Apr 2025, 6:32 PM
#5
swguy avatar

swguy

Administrator

Join Date:
Feb 2006
Location:
Tampa Bay, Florida
Posts:
10,725
Plugin Contributions:
56

Re: helcim payments by mxWorks.cc

pci is all about scope ...

This is a great framing, thank you.

v1.0.1 submitted.

Update is now approved.

That Software Guy. My Store: Zen Cart Support
Available for hire - See my ad in Services
Plugin Moderator, Documentation Curator, Chief Cook and Bottle-Washer.
Do you benefit from Zen Cart? Then please support the project.

10 Apr 2025, 5:31 AM
#6
clam_man avatar

clam_man

New Zenner

Join Date:
Jun 2019
Location:
Austin TX
Posts:
65
Plugin Contributions:
0

Re: helcim payments by mxWorks.cc

I attempted the 1.5.8a install and there's nothing output to the error logs. If I click 'Install' on the plugin page it just reloads the page with no error output to the page or logs. I've gone over the changes in the orders.php file and that should be easy enough to fix but I need to figure out why the installer is failing first and then I can start to figure out how to get this to work for 1.5.8a. I'll be back if I don't find any glaring issues with the sql queries.

10 Apr 2025, 5:55 AM
#7
carlwhat avatar

carlwhat

zennedOut

Join Date:
Nov 2005
Location:
los angeles
Posts:
2,972
Plugin Contributions:
8

Re: helcim payments by mxWorks.cc

clam_man:

I attempted the 1.5.8a install and there's nothing output to the error logs. If I click 'Install' on the plugin page it just reloads the page with no error output to the page or logs. I've gone over the changes in the orders.php file and that should be easy enough to fix but I need to figure out why the installer is failing first and then I can start to figure out how to get this to work for 1.5.8a. I'll be back if I don't find any glaring issues with the sql queries.

the installer will never work in a v158a environment. it makes use of the some methods (specifically addConfigurationKey) which is not available in v158.

as to why you are not getting logs, my guess is that php error logs are getting created, but the zc override of those log errors has not loaded at that time.

i would look at:

zc_plugins/mxWorksHelcim/1.0.1/Installer/ScriptedInstaller.php

and specifically at the insert constants method and rewrite that and see if it works.

all we are doing are adding some constants there, and there are plenty of examples out there as to how add those config values to the configuration table. look at one of my other payment modules, or any plugin that adds values to the configuration table.

i would think that the creation of the helcim tables will work just fine as those methods were available in v158a.

good luck.

author of square Webpay, now with Apple Pay and Google Pay.
mXworks
donations: venmo or paypal accepted.
premium consistent excellent support. available for hire.

10 Apr 2025, 2:36 PM
#8
carlwhat avatar

carlwhat

zennedOut

Join Date:
Nov 2005
Location:
los angeles
Posts:
2,972
Plugin Contributions:
8

Re: helcim payments by mxWorks.cc

in thinking about this further, even after you get the installer to work, the encapsulation in v158 will, in all likelihood, not work.

to get this to work in v158a, you will need to de-encapsulate all of the various scripts.

as far as the code for installing goes, you can use this as a model to replace the aforementioned script. ensure that all of the config values are included from the released version as they may not all be included here:

global $db;

            if (!defined('MODULE_PAYMENT_HELCIM_STATUS')) {
                $db->Execute("INSERT INTO " . TABLE_CONFIGURATION . " (configuration_title, configuration_key, configuration_value, configuration_description, configuration_group_id, sort_order, set_function, date_added) VALUES ('Enable Helcim Payments', 'MODULE_PAYMENT_HELCIM_STATUS', 'True', 'Do you want to accept Helcim payments?', '6', '0', 'zen_cfg_select_option(array(\'True\', \'False\'), ', now())");
            }
            if (!defined('MODULE_PAYMENT_HELCIM_API_TOKEN')) {
                $db->Execute("INSERT INTO " . TABLE_CONFIGURATION . " (configuration_title, configuration_key, configuration_value, configuration_description, configuration_group_id, sort_order, date_added, use_function) VALUES ('Application ID', 'MODULE_PAYMENT_HELCIM_API_TOKEN', '', 'Enter the API Token from your Dashboard.  (All Tools; Integrations; API Access)', '6', '0',  now(), 'zen_cfg_password_display')");
            }
            if (!defined('MODULE_PAYMENT_HELCIM_TRANSACTION_TYPE')) {
                $db->Execute("INSERT INTO " . TABLE_CONFIGURATION . " (configuration_title, configuration_key, configuration_value, configuration_description, configuration_group_id, sort_order, set_function, date_added) VALUES ('Transaction Type', 'MODULE_PAYMENT_HELCIM_TRANSACTION_TYPE', 'purchase', 'Should payments be [authorized] only, or be completed [purchases]?<br>NOTE: If you use [authorize] then you must manually capture each payment within 6 days or it will be voided automatically.', '6', '0', 'zen_cfg_select_option(array(\'authorize\', \'purchase\'), ', now())");
            }
            if (!defined('MODULE_PAYMENT_HELCIM_SORT_ORDER')) {
                $db->Execute("INSERT INTO " . TABLE_CONFIGURATION . " (configuration_title, configuration_key, configuration_value, configuration_description, configuration_group_id, sort_order, date_added) VALUES ('<hr>Sort order of display.', 'MODULE_PAYMENT_HELCIM_SORT_ORDER', '0', 'Sort order of displaying payment options to the customer. Lowest is displayed first.', '6', '0', now())");
            }
            if (!defined('MODULE_PAYMENT_HELCIM_ZONE')) {
                $db->Execute("INSERT INTO " . TABLE_CONFIGURATION . " (configuration_title, configuration_key, configuration_value, configuration_description, configuration_group_id, sort_order, use_function, set_function, date_added) VALUES ('Payment Zone', 'MODULE_PAYMENT_HELCIM_ZONE', '0', 'If a zone is selected, only enable this payment method for that zone.', '6', '2', 'zen_get_zone_class_title', 'zen_cfg_pull_down_zone_classes(', now())");
            }
            if (!defined('MODULE_PAYMENT_HELCIM_ORDER_STATUS_ID')) {
                $db->Execute("INSERT INTO " . TABLE_CONFIGURATION . " (configuration_title, configuration_key, configuration_value, configuration_description, configuration_group_id, sort_order, set_function, use_function, date_added) VALUES ('Set Order Status', 'MODULE_PAYMENT_HELCIM_ORDER_STATUS_ID', '2', 'Set the status of Paid orders made with this payment module to this value', '6', '0', 'zen_cfg_pull_down_order_statuses(', 'zen_get_order_status_name', now())");
            }
            if (!defined('MODULE_PAYMENT_HELCIM_REFUNDED_ORDER_STATUS_ID')) {
                $db->Execute("INSERT INTO " . TABLE_CONFIGURATION . " (configuration_title, configuration_key, configuration_value, configuration_description, configuration_group_id, sort_order, set_function, use_function, date_added) VALUES ('Set Refunded Order Status', 'MODULE_PAYMENT_HELCIM_REFUNDED_ORDER_STATUS_ID', '1', 'Set the status of refunded orders to this value', '6', '0', 'zen_cfg_pull_down_order_statuses(', 'zen_get_order_status_name', now())");
            }
            if (!defined('MODULE_PAYMENT_HELCIM_LOGGING')) {
                $db->Execute("INSERT INTO " . TABLE_CONFIGURATION . " (configuration_title, configuration_key, configuration_value, configuration_description, configuration_group_id, sort_order, set_function, date_added) VALUES ('Log Mode', 'MODULE_PAYMENT_HELCIM_LOGGING', 'Log on Failures', 'Would you like to enable debug mode?  All transactions will be stored in the database, and/or emailed to store owner.', '6', '0', 'zen_cfg_select_option(array(\'Log Always\', \'Log on Failures\', \'Log Always and Email on Failures\', \'Log on Failures and Email on Failures\'), ', now())");
            }
            if (!defined('MODULE_PAYMENT_HELCIM_P_TOKEN')) {
                $db->Execute("INSERT INTO " . TABLE_CONFIGURATION . " (configuration_title, configuration_key, configuration_value, configuration_description, configuration_group_id, sort_order, date_added) VALUES ('p Token', 'MODULE_PAYMENT_HELCIM_P_TOKEN', 'd574f1aca93a65', 'P Token; DO NOT CHANGE!', '6', '155',  now())");
                define('MODULE_PAYMENT_HELCIM_P_TOKEN', 'd574f1aca93a65');
            }

best.

author of square Webpay, now with Apple Pay and Google Pay.
mXworks
donations: venmo or paypal accepted.
premium consistent excellent support. available for hire.

5 May 2025, 9:46 PM
#9
larsaquatics avatar

larsaquatics

New Zenner

Join Date:
Apr 2025
Location:
Silver Springs, FL https://larsaquatics.com
Posts:
1
Plugin Contributions:
0

Re: helcim payments by mxWorks.cc

Awesome work on this payment method. Working great on my zen-cart. By any chance do you have a way to apply a ACH transaction to the checkout as well? This would be great for wholesale customers... I wouldn't use it for retail customers.

Thanks!

My Zen-Cart Https://larsaquatics.com

Cheers!

6 May 2025, 12:45 AM
#10
carlwhat avatar

carlwhat

zennedOut

Join Date:
Nov 2005
Location:
los angeles
Posts:
2,972
Plugin Contributions:
8

Re: helcim payments by mxWorks.cc

larsaquatics:

Awesome work on this payment method. Working great on my zen-cart. By any chance do you have a way to apply a ACH transaction to the checkout as well? This would be great for wholesale customers... I wouldn't use it for retail customers.

Thanks!

hey lars,
that's great that you like it and hopefully are using it! i put a bunch of effort into making it work and as seemless as possible with the ZC standard 3 page checkout as well as one page checkout (OPC).

as you are aware, it it a totally encapsulated plugin, which while great, unfortunately limits its use to store owners running zc v210. i am thinking about a new version that is not encapsulated for those store owners running v157 or v158. although i am not sure about it at this time. (perhaps it will encourage other store owners to update to the latest ZC version.)

currently i have not coded ACH transfers, although it does seem that helcim offers that transaction type.

i have a number of things on my plate right now; but if enough people start using this module (or someone wants to pay for the development of ACH transfers) i will add that to its functionality in a future release.

best.

author of square Webpay, now with Apple Pay and Google Pay.
mXworks
donations: venmo or paypal accepted.
premium consistent excellent support. available for hire.

6 Sep 2025, 8:28 PM
#11
foghead avatar

foghead

New Zenner

Join Date:
Dec 2021
Location:
Tennessee
Posts:
43
Plugin Contributions:
0

Re: helcim payments by mxWorks.cc

Hey Carl
Thanks for taking the time and effort to create another payment option for Zen Cart.
I too would like to see the ACH option in the future if possible.
I just completed the update from 2.0.1 to 2.1.0 and installed the Helcim payment module.
I have not created an Helcim account yet as I am waiting on the store owner for more information.
Is it possible to do any testing at this point, if so how do I test? How do I test after creating the
account? Thanks much, any info will be appreciated.
I will be making a contribution soon.

6 Sep 2025, 8:56 PM
#12
carlwhat avatar

carlwhat

zennedOut

Join Date:
Nov 2005
Location:
los angeles
Posts:
2,972
Plugin Contributions:
8

Re: helcim payments by mxWorks.cc

Foghead:

Hey Carl
Thanks for taking the time and effort to create another payment option for Zen Cart.
I too would like to see the ACH option in the future if possible.
I just completed the update from 2.0.1 to 2.1.0 and installed the Helcim payment module.
I have not created an Helcim account yet as I am waiting on the store owner for more information.
Is it possible to do any testing at this point, if so how do I test? How do I test after creating the
account? Thanks much, any info will be appreciated.
I will be making a contribution soon.

for testing, a testing api is already provided. just use a credit card number of:

4111111111111111

any expiration date in the future, and a ccv value of 123.

else you can use the numbers you see here:

https://devdocs.helcim.com/docs/test-credit-card-numbers

with regards to being in test or live mode, everything is tied to your API token. you can see that in your admin -> modules -> payment -> helcim:

Key: MODULE_PAYMENT_HELCIM_API_TOKEN
API Token
Enter the API Token from your Helcim Dashboard. Go to All Tools => Integrations => API Access

once you get your own account, you will need to replace that value with either your live or test value.

the folks at helcim can, for sure, help you out with that.

but feel free to run test transactions using the API code provided in the code. that is a test token, so no lives transactions will happen.

best.

author of square Webpay, now with Apple Pay and Google Pay.
mXworks
donations: venmo or paypal accepted.
premium consistent excellent support. available for hire.

7 Sep 2025, 12:34 AM
#13
foghead avatar

foghead

New Zenner

Join Date:
Dec 2021
Location:
Tennessee
Posts:
43
Plugin Contributions:
0

Re: helcim payments by mxWorks.cc

Thanks for the quick reply. I have been testing using the info you provided, it works without any errors.
We should have the account setup Monday. Thanks again.

8 Sep 2025, 6:24 PM
#14
carlwhat avatar

carlwhat

zennedOut

Join Date:
Nov 2005
Location:
los angeles
Posts:
2,972
Plugin Contributions:
8

Re: helcim payments by mxWorks.cc

Foghead:

Thanks for the quick reply. I have been testing using the info you provided, it works without any errors.
We should have the account setup Monday. Thanks again.

foghead, i have closed the batch. you can now test refunds if so desired.

please note that there are 2 different UIs available to use for refunds, voids, and captures. one makes use of the zen-cart coded payment admin methods. the 2nd UI is something that i developed and has been in use on some of my other payment modules.

there is a config value on the admin, and one can change in between the 2 UIs at any time without any loss of data. the key value is listed at the end.

Key: MODULE_PAYMENT_HELCIM_ADMIN_MANAGE
Select type of handling options in admin.
How do you want to see and handle payments/refunds/voids on the admin side? (Default is StandardZC)
StandardZC
HelcimTable

please note that this value is system wide and not available on a per user basis.

best.

author of square Webpay, now with Apple Pay and Google Pay.
mXworks
donations: venmo or paypal accepted.
premium consistent excellent support. available for hire.

8 Nov 2025, 4:27 PM
#15
stitchnkitty avatar

stitchnkitty

Totally Zenned

Join Date:
Jun 2009
Location:
Des Moines, Iowa USA
Posts:
618
Plugin Contributions:
0

Re: helcim payments by mxWorks.cc

Good morning -
I am totally a non techie, I have originally started zencart in 2009. Back then, there was a module "Ceon credit card payment module" that will collect card information and split the information for transmission, maintaining part in the website and transmitting part to email. When the order is ready, I process the card on my process machine. This allows us to not ship expensive orders submitted by clients that use US addresses but destination in questionable countries.
This module is no longer maintained to the current levels of Zencart because there was not anything I could use that offered these features.
I have put off upgrading, but now I am forced to by my host, Is this module what I am looking for?

Thank you so much for your response.

stitchnkitty

stitchnkitty

8 Nov 2025, 5:34 PM
#16
swguy avatar

swguy

Administrator

Join Date:
Feb 2006
Location:
Tampa Bay, Florida
Posts:
10,725
Plugin Contributions:
56

Re: helcim payments by mxWorks.cc

This module and other newer modules allow you to authorize but not charge the card.

See

https://docs.zen-cart.com/user/payment/auth_only/

That Software Guy. My Store: Zen Cart Support
Available for hire - See my ad in Services
Plugin Moderator, Documentation Curator, Chief Cook and Bottle-Washer.
Do you benefit from Zen Cart? Then please support the project.

9 Nov 2025, 1:56 PM
#17
stitchnkitty avatar

stitchnkitty

Totally Zenned

Join Date:
Jun 2009
Location:
Des Moines, Iowa USA
Posts:
618
Plugin Contributions:
0

Re: helcim payments by mxWorks.cc

I do not have a gateway system - But a desktop card swipe or manual transaction terminal. Will this still work?

10 Nov 2025, 6:57 AM
#18
carlwhat avatar

carlwhat

zennedOut

Join Date:
Nov 2005
Location:
los angeles
Posts:
2,972
Plugin Contributions:
8

Re: helcim payments by mxWorks.cc

stitchnkitty:

I do not have a gateway system - But a desktop card swipe or manual transaction terminal. Will this still work?

no.

you need to sign up at:

https://www.helcim.com/

best.

author of square Webpay, now with Apple Pay and Google Pay.
mXworks
donations: venmo or paypal accepted.
premium consistent excellent support. available for hire.

10 Nov 2025, 11:12 AM
#19
swguy avatar

swguy

Administrator

Join Date:
Feb 2006
Location:
Tampa Bay, Florida
Posts:
10,725
Plugin Contributions:
56

Re: helcim payments by mxWorks.cc

But a desktop card swipe or manual transaction terminal. Will this still work?

If you want to do it this way, you can, but it requires two steps:

  • take the order without payment details (using the Invoice payment module or Check/Money Order).

  • call the customer to get their credit card info, and run a transaction while they're on the phone.

https://docs.zen-cart.com/user/payment/offline/

If you use a payment module like helcim, it's a one step process with less work for you.

That Software Guy. My Store: Zen Cart Support
Available for hire - See my ad in Services
Plugin Moderator, Documentation Curator, Chief Cook and Bottle-Washer.
Do you benefit from Zen Cart? Then please support the project.

19 Nov 2025, 8:32 PM
#20
foghead avatar

foghead

New Zenner

Join Date:
Dec 2021
Location:
Tennessee
Posts:
43
Plugin Contributions:
0

Re: helcim payments by mxWorks.cc

I just want to say Thanks for all the efforts in creating the Helcim plugin.
It was very easy to install and get up and working. Helcim is the best payment option
ever in my opinion. It is working flawlessly with Zen Cart 2.10. No errors at all.
Very to get setup and easy to use, tech support is great as well as the rates.
We have done at lot of ACH transfers using the invoice function.
It would be nice if ACH could be added to the plugin.
Thanks much for all your work on this great payment module.