Creating a new config
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 | Whether the configuration should be active and accepting transactions. |
Include XML on Response | Whether the Helcim.js response should include a XML on the response (along with the rest of the POST fields). This is needed for some plugin configurations. |
Name | A nickname for your reference. |
Transaction settings
Test Mode | Whether transactions passed through this Helcim.js config should be in test-mode or live authorizations. |
Currency | The transaction currency (must be supported by your Helcim account). |
Transaction Type | Whether transactions processed through this config should be "purchase" or "verify". Verifies are $0 transactions that only tokenize the cards. |
Terminal | The terminal that should be used for these transactions. |
Security settings
Enforce Hashing | 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 | The minimum captcha score needed for the transaction to be allowed to process. 1.0 is very likely a good interaction, 0.0 is very likely a bot. |
Once ready, click Save
to create the new configuration.
After you click Save
a new configuration token will be genrated under the Security Settings. Scroll down to copy and paste the token as part of your Helcim.js HTML integration.
Updated 9 months ago