Skip to main content (Press Enter)
Helcim Logo
Click here if you return to contents

WooCommerce Integration with Helcim.js Version 2.0.0

Below are the instructions for integrating your Helcim account into WooCommerce, using Helcim.js as the integration method.

For more options and links to the plugin, please click here.

If you are using a plugin version below 2.0.0 please click here.

Step 1 | API Configuration

  1. Login to your Helcim account
  2. Click on Integrations in the left menu
  3. Click on API Access in the left sub-menu
  4. Click on New API Access in the top-right hand corner of your screen
  5. Create a configuration using the settings below
  6. Click Save
  7. Copy the generated API token (use your token, the one on screenshot below is just an example)


Status: Active
Name: WooCommerce
Token: Generated by the system
Transaction Processing: On
Void: On
Refund: On
Terminal: please select terminal (s) you will be using. (Do not choose DEMO unless using a DEMO account for testing purposes)
Invoices: Check View and Modify
Customers, Orders, Products, Recurring Plans, Subscriptions and Online Store: Leave these boxes unchecked

Please ensure that Invoices View and Modify are checked for the integration to work as intended.

Step 2 | Helcim.js Configuration

  1. Click on Integrations in the left menu
  2. Click on Helcim.js Configurations in the left sub-menu
  3. Click on New Configuration in the top-right
  4. Create a configuration using the settings below
    Status: Active
    Include XML on Response: On Name: WooCommerce
    Test Mode: No
    Currency: please select one
    Transaction Type: Card Purchase or Preauth
    Terminal: please select one
    Enforce hashing: No
    Amount Minimum: 0
    Amount Maximum: 0
    Require Captcha: Yes
    Captcha Score Threshold: Must be greater than 0.01 and less than 0.99
  5. Click Save
  6. Copy the generated Helcim.js token and Secret Key (Be sure to copy your own token, the one in the screenshot below is just an example)

Step 3 | Terminal Number

  1. Click on Payments in the menu bar on the left-hand side of your screen
  2. Click on Terminals and select the terminal that you are using for the integration
  3. Note the Terminal number next to your active terminal as it is required for the WooCommerce settings in the plugin.

Step 4 | WooCommerce Settings

Install the plugin, or download it and extract it to: /wp-contents/plugins/ directory

  1. Configure the module by selecting WooCommerce and Settings on the right-hand side of your screen. Click on Payments from the tab in the middle of your screen. Scroll down to Payment Methods where you will see HelcimCommerce listed.
  2. Click the Enable/Disable box to enable this gateway
  3. Test Mode - click checkbox for ON or OFF
  4. Enter the title to display on the payment selection portion of the checkout page
  5. Select Helcim.js for Payment Method
  6. Enter Helcim.js Token if Payment Method is Helcim.js
  7. Enter Account ID (Helcim Account ID)
  8. Enter Secret Key (Helcim Secret Key)
  9. Choose between Purchase and Pre-auth for transaction type
  10. Enter Terminal ID (Helcim Commerce Terminal ID)
  11. Enter the description your customers will see on the checkout page for this payment option (THIS IS A REQUIRED FIELD)
  12. Choose whether or not you would like to show the Helcim logo on the checkout page
  13. Select Require Captcha if also set in Helcim.js setup

You can find your Account ID by clicking on All Tools in the top left-hand corner of your screen, then Settings, and My Account. You can find the detailed instructions here.

Related Articles

WooCommerce Integration - Legacy Gateway
WooCommerce Direct Integration Instructions
Multiple Currencies in WooCommerce
Troubleshooting Your WooCommerce Integration
Refunding a transaction with WooCommerce

Was this article helpful?

Feedback submitted - Thank you!

If you need immediate assistance please contact our Merchant Experience Specialists here