Differences

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

--- gateways:helcim [2015/12/16 19:53] – [Troubleshooting & Interpreting Response Codes] helcim
+++ 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).
+====== Helcim Commerce Transaction Solutions ======
-# Version numbers should include applicable decimals, such as "0.7.0" and not "070"
+===== Setting Up Helcim for FoxyCart =====
-support-added   : 0.7.2
-support-removed :
-# Features and Details
+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:
-auth-net-emulation : no # enter "yes" or "no" (without quotes)
+Log in to your Helcim account or developer test account
-supports-3dsecure  : no # enter "yes" or "no" (without quotes)
+Click All Tools in the top-left corner
-supports-multicurrency  : # enter "yes" or "no" (without quotes)
+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
-# Gateway URL
+  - Log in to the Helcim administration.
-gateway_url     : https://www.helcim.com/cart/foxycart/
+  - Click the "All Tools" option in the top left hand corner and select "Integrations" under "Merchant Tools"
-----
+  - Click the "New API Access" button at the top of the page
+  - Give the API token a name (like "Foxy.io" for example)
+  - Do **not** check the "I will use this token for a checkout integration" checkbox
-====== Helcim Online Transaction Solutions for Canada ======
+  - In the "Access Restrictions", "General" and "Settings" can be set to "Read", but "Transaction Processing" should be set to "Admin"
-===== Setting Up Helcim for FoxyCart =====
+  - Save the API token
+  - Once saved, within the "API Access Information" section, the "Token" value is available, which is the value you need to enter in Foxy.
-<wrap important>Support and documentation coming in v0.7.2.</wrap>
+  - 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 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 ====
-[[https://www.helcim.com/us/virtual-terminal/pricing/|US - Get started with the Helcim Payment Gateway]]
+Contact helcim for info. <wrap help>Know more? Feel free to edit this page with info.</wrap>
-[[https://www.helcim.com/ca/virtual-terminal/pricing/|Canada - Get started with the Helcim Payment Gateway]]
-   [[https://www.helcim.com/us/virtual-terminal/payment-gateway-api/|Payment Gateway API access for developers]]
 ==== Test Card Numbers ====
 Contact helcim for info. <wrap help>Know more? Feel free to edit this page with info.</wrap>
@@ Line 44: / Line 52: @@
 ===== Troubleshooting & Interpreting Response Codes =====
 View Helcim Support for all [[https://www.helcim.com/support/article/115-helcim-gateway-api-response-variables/|payment gateway response code variables]]
+[[https://www.helcim.com/us/virtual-terminal/|Learn more about the Gateway and Virtual Terminal]]
-   [[https://www.helcim.com/us/virtual-terminal/|Learn more about the Gateway and Virtual Terminal]]
-===== Important Notes and Caveats =====
-===== User Notes and Experiences =====
-<wrap tip>If you have tips, experience, or helpful notes related to this gateway that would benefit others, please add them below, including your name and the date.</wrap> We reserve the right to edit or remove comments that don't add value to this page.

Differences

Page Tools

Site Tools

User Tools