---- dataentry gateway ----
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/
----



====== 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.
  - 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
  - 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 value you need to enter in Foxy.
  - 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 ====
Contact helcim for info. <wrap help>Know more? Feel free to edit this page with info.</wrap>

==== Test Card Numbers ====
Contact helcim for info. <wrap help>Know more? Feel free to edit this page with info.</wrap>



===== 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]]