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

Creating a New Helcim.js Configuration

Helcim.js requires a configuration to be created in order to work.

This configuration will control your transaction and security settings, ensuring that the end-user cannot modify your desired settings. To create a new configuration, click on Integrations and Helcim.js Configurations to get started. Once you are on the main Helcim.js Configurations landing page click on New Configuration in the top right-hand corner to get started. You can now work through the different fields to custom your Helcim.js Settings.

General Settings

Field Name Description
Active Toggle On or Off to enable this configuration.
Include XML on Response Toggle On or Off to enable this configuration.
Name A nickname for your reference.

Transaction Settings

Field Name Description
Test Mode Toggle On or Off if transactions should be processed live or in test-mode.
Currency The transaction currency (must be supported by the terminal).
Transaction Type The type of transaction you wish to process, such as "purchase" or "verify".
Terminal The terminal to use for the transaction.

Security Settings

Field Name Description
Enforce Hashing Toggle On or Off whether amount hashing is required. Please see hashing instructions for more details.
Amount Minimum The minimum amount that can be processed using this configuration. Setting a minimum helps to prevent card-testing on your checkout page.
Amount Maximum The maximum amount that can be processed using this configuration. 0 = no limit.
Require Captcha With this option set as Yes it will enable ReCaptcha v3. Additional code will need to be added to be implemented for Captcha to work correctly. Instructions to produce the code using the Code Generator can be found here.
Captcha Score Threshold If this minimum score is not met the transaction will not process. 1.0 is very likely a good interaction, 0.0 is very likely a bot.

Click on Save to create the new configuration. After you click Save a new Token will be generated under the Security Settings, scroll down to copy and paste the token as part of your Helcim.js HTML integration.

Related Articles

An Overview of Helcim.js
Editing or Deleting a Helcim.js Configuration
Using the Helcim.js Code Generator
Request Fields
Response Fields
HTML Structure
SSL, Security and Hashing

Was this article helpful?

Feedback submitted - Thank you!

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