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

WooCommerce Helcim.js Instructions

The integration instructions below are for a previous version of the plugin, we recommend upgrading to the latest version of the integration. To view details on accessing the latest version of the plugin, please visit our support article here.

Below are the instructions for integrating Helcim into WooCommerce, using Helcim.js as the integration method. For more options and links to the plugin, 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
Nickname: WooCommerce
Token: Generated by the system
Transactions: select Process
Name: WooCommerce
Terminal: please select terminal (s) you will be using. (Do not choose DEMO unless using a DEMO account for testing purposes)
Customers, Orders, Products, Recurring Plans, Subscriptions and Online Store: Leave these boxes unchecked


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
    Name: WooCommerce
    Test Mode: No
    Currency: please select one
    Transaction Type: Card Verify (Tokenize Only)
    Terminal: please select one
    Enforce hashing: No
    Amount Minimum: 0
    Amount Maximum: 0
    Require Captcha: Yes or No (Optional)
    Captcha Score Threshold: Must be greater than 0.01 and less than 0.99
  5. Click Save
  6. Copy the generated Helcim.js token (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 https://en-ca.wordpress.org/plugins/helcim-commerce-for-woocommerce/

  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. Choose between the two payment Methods (Helcim.js or Direct Integration)
  6. Enter Helcim.js Token if Payment Method is Helcim.js
  7. Enter Account Id (Helcim Commerce Account Id)
  8. Enter API Token (Helcim Commerce API Access Token)
  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 Cog Icon in the top right-hand corner of your screen, then Settings, General Settings, and My Account. You can find the detailed instructions here.

Was this article helpful?

Feedback submitted - Thank you!

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