Differences

This shows you the differences between two versions of the page.

--- gateways:helcim [2022/05/09 16:44] – [Setting Up Helcim for FoxyCart] adam
+++ gateways:helcim [2026/07/01 22:19] (current) – [Setting Up Helcim for FoxyCart] adam
@@ Line 1: / Line 1: @@
 ---- dataentry gateway ----
-type            : gateway         # do not change this line
+type                   : gateway # do not change this line
+name                   : Helcim
+countries              : CA, US
+support-added          : 0.7.2
+support-removed        :
+auth-net-emulation     : no # enter "yes" or "no" (without quotes)
+supports-3dsecure      : no # enter "yes" or "no" (without quotes)
+supports-multicurrency :  # enter "yes" or "no" (without quotes)
+gateway_url            : https://www.helcim.com/cart/foxycart/
+----
-# Add the full name of the gateway after the colon below.
-name            : Helcim
-# Supported Countries. Please use 2-character ISO Country Codes available at
-# http://www.iso.org/iso/english_country_names_and_code_elements
-# Separate multiple country codes by commas.
-countries       : CA
-# Enter the FoxyCart versions where support was added or removed (if applicable).
-# Version numbers should include applicable decimals, such as "0.7.0" and not "070"
-support-added   : 0.7.2
-support-removed :
-# Features and Details
-auth-net-emulation : no # enter "yes" or "no" (without quotes)
-supports-3dsecure  : no # enter "yes" or "no" (without quotes)
-supports-multicurrency  : # enter "yes" or "no" (without quotes)
-# Gateway URL
-gateway_url     : https://www.helcim.com/cart/foxycart/
-----
-====== Helcim Online Transaction Solutions for Canada ======
+====== Helcim Commerce Transaction Solutions ======
 ===== Setting Up Helcim for FoxyCart =====
 For connecting your Helcim account to Foxy, there are two pieces of information from your account that is needed to be entered into Foxy, the merchant/account ID and the API token. Follow these steps for getting those for your account:
+Log in to your Helcim account or developer test account
+Click All Tools in the top-left corner
+Select Integrations under Merchant Tools
+Ensure you are on the API Access Configurations page
+Click New API Access to get started
+Enter a name for your API Access Configuration
+Select the checkout integration checkbox if you are integrating with HelcimPay.js and enter the URLs where it will be hosted
+Select the appropriate Access Restrictions for your token
+Click on Create located in the top right to save the configuration and generate your token
   - Log in to the Helcim administration.
-  - Go to the "Settings" page - available from the "All Tools" section through the grid icon in the top left hand corner of the page
+  - Click the "All Tools" option in the top left hand corner and select "Integrations" under "Merchant Tools"
-  - Under "General Settings", go to "My Account"
-  - Within the "Merchant Information" panel, the "Account ID" value is available. This is the first value needed for Foxy
-  - Back within the "All Tools" section, go to the "Integrations" page
   - Click the "New API Access" button at the top of the page
   - Give the API token a name (like "Foxy.io" for example)
-  - Enable the "Transaction Processing" toggle, and then enable "Void", "Refund" and "Settle" permissions, as well as the terminal(s) that you will want Foxy to work with.
+  - Do **not** check the "I will use this token for a checkout integration" checkbox
+  - In the "Access Restrictions", "General" and "Settings" can be set to "Read", but "Transaction Processing" should be set to "Admin"
   - Save the API token
-  - Once saved, within the "API Access Information" section, the "Token" value is available, which is the second value you need to enter in Foxy.
+  - Once saved, within the "API Access Information" section, the "Token" value is available, which is the value you need to enter in Foxy.
-  - With the two values you need, log in to the Foxy administration, and on the "Payment" page of the Foxy administration, enable the "Let customers pay with a Credit or Debit Card" and select "Helcim Commerce" from the list. Enter the two values you got from Helcim into the respective fields (Account ID into "merchant id", Token into "token") in Foxy and save the updated payment settings.
+  - Log in to the Foxy administration, and on the "Payment" page of the Foxy administration, enable the "Let customers pay with a Credit or Debit Card" and select "Helcim" from the list. Enter the API token you got from Helcim into the respective field in Foxy
+  - Optionally configure your verification option (we generally recommend "Enabled, automatically") and enter your Terminal ID from Helcim if needed.
+  - Save the updated payment settings.
 ==== Important: Request Full Card Numbers for your Helcim account ====
-As part of Foxy's integration with Helcim, you will need to request that your Helcim account be enabled for using Full Card Numbers with their API with Helcim's support team. This is enabled on a per account basis, but you can let the Helcim support team know that you're using Foxy.io for your ecommerce. Helcim will require some attestation of your PCI compliance, but there shouldn't be any cost associated with that.
+As part of Foxy's integration with Helcim, you will need to request that your Helcim account be enabled for using Full Card Numbers with their API with Helcim's support team. This is enabled on a per account basis, but you can let the Helcim support team know that you're using Foxy.io for your ecommerce. Helcim will reach out to us to confirm that you are a Foxy.io user before enabling it for your account. They will also require some attestation of your PCI compliance, but that should be fairly simple (as Foxy is the one actually handling the card data), and there shouldn't be any additional costs associated with that.
 ===== Testing =====
 ==== Obtaining a Test Account ====

Differences

Page Tools

Site Tools

User Tools