- 03 Jul 2024
- 2 Minutes to read
- Print
Configuring the Helcim payments plugin for WooCommerce
- Updated on 03 Jul 2024
- 2 Minutes to read
- Print
The following article covers the steps for configuring your Helcim Commerce for WooCommerce plugin. This involves creating the relevant API Access and Helcim.js Configurations in your Helcim accounts Integrations section and then copy the relevant account details into your plugin settings page.
If you have not yet installed the Helcim payments plugin into your WordPress website, you can find more information here.
Step 1 | API Configuration
The Helcim payments plugin requires you to create an API access token in order to secure your payment processing through WooCommerce.
- Login to your Helcim account.
- Click on All Tools and select Integrations from the menu.
- Click on New API Access from the main page.
- Create an API Access Configuration using the following settings:
- Name: WooCommerce
- Access Restrictions:
- General: Read & Write
- Settings: Read
- Transaction Processing: Admin
- Click Create to save your new configuration. This will create a unique API Access token that you will copy and paste into your WooCommerce settings later in the configuration process.
Step 2 | Helcim.js Configuration
The Helcim Commerce for WooCommerce plugin uses Helcim.js in order to verify and encrypt credit card details, before processing them through the Helcim Payment API. You will now create a Helcim.js Configuration in order to keep your website and processing out of scope of stricter PCI compliance requirements.
- Click on All Tools and select Integrations from the menu.
- Click on Helcim.js Configurations in the left sub-menu.
- Click on New Configuration on the main page.
- Create a Helcim.js Configuration using the settings below:
- General Settings:
- Status: Active
- Include XML on Response: On
- Name: WooCommerce
- Transaction Settings:
- Test Mode: No
- Currency: Please select an available currency for processing
- Transaction Type: Card Verify (Tokenize Only)
- Terminal: Please select an available processing terminal
- Security Settings:
- Enforce Hashing: No
- Amount Minimum: 0
- Amount Maximum: 0
- Require Captcha: Yes
- Captcha Score Threshold: We recommend starting with 0.5
- Enforce Hashing: No
- General Settings:
- Click Save to create your new Helcim.js Configuration. This will generate a unique Helcim.js token and secret key in the Security Settings section of your new Helcim.js Configuration, that you will copy into your WooCommerce settings.
Step 3 | WooCommerce Settings
Once your Helcim API Access Configuration and Helcim.js Configurations have been created, you can complete the final configuration steps in your WooCommerce plugin.
- Configure the module by selecting WooCommerce and Settings on the left-hand side of your screen.
- Click on Payments from the tabs in the middle of your screen.
- Click Manage for the "HelcimCommerce" for WooCommerce plugin.
- Enter the following information into your Helcim Commerce for WooCommerce settings page:
- Enable/Disable: Check the Enable Helcim Payment Module check box to enable the plugin.
- Test Mode: Check the Test Mode box if you are testing payments through the plugin. Please note that this will only apply to the Verify transactions processed through the payment plugin.
- Payment Method: Helcim JS.
- Helcim JS Token: Enter the Helcim.js token generated in your Helcim.js Configuration created in Step 2.
- Helcim JS Secret Key: Enter the Secret Key generated in your Helcim.js Configuration created in Step 2.
- Account Id: Enter your Helcim commerce Account ID found in your Helcim account by selecting All Tools, Settings, and then My Account.
- API Token: Enter the Helcim API token generated in your API Access Configuration created in Step 1.
- Transaction Type: Choose between Purchase and Pre-authorization for transaction type. When selecting Pre-authorization, you will need to manually Capture payments from your Helcim Payments section within 7 days of your pre-auth transaction being processed or they will expire.
- Description: Enter the description your customers will see on the checkout page for this payment option. This is a required field.
- Helcim Logo: Check the Show Helcim logo on checkout option to display the payment processor logo.
- Click Save changes to complete your Helcim Commerce for WooCommerce setup and configuration. You final settings page should look something like this, with your own valid configuration settings from your Helcim account.