Connect to Helcim

Connect to Helcim

Step 1:

• Click this link to open your Benji Pays Payment Gateway Settings in a new window.
• Click the green Add New Gateway button
• Select Helcim CAD or USD on the window that opens. You will now see all the required fields for your Gateway configuration.
• Enter a description for this Gateway, such as "Helcim CAD"
• Select a deposit account for each currency that transactions processed through this Gateway will be posted to in your accounting system.

Step 2: Now we need to get your Account ID. You can find your Account ID by going to Helcim website  and clicking on Settings> General Settings> My account.

Copy your Helcim Account ID and paste this into the Helcim Account ID field in the Benji Pays Payment Gateway Settings window.

Step 3: To get your API Key, go to https://hub.helcim.com/login/, Login using your Helcim credentials.

b: Click "All Tools" and then click "Integrations"

Step 4: 

1. Click "Legacy API Access"

2. Click "New API Access"

Fill out the form that opens as follows:

• Active: leave this on (switch will be bluish in colour)
• Name: Benji Pays
• Transaction Processing: Turn this on (switch will be bluish in colour) and then ensure the selected options look like below. 
• Terminals - Choose only ONE terminal and ensure it's setup for the currency you want to use in Benji Pays.  If you would like multiple currencies, create an API access for each currency and setup a gateway connection in Benji Pays for each currency.  
• Selecting the correct currency here and in Step 1 is important and they must match.  Your transactions will be processed in the currency of the terminal you select here even if you select a different currency in Benji Pays. 
• Access Restrictions - Set these to look like below:

Step 5: Click Save in the top right corner of the page. Once the confirmation that the save was successful, click API Access Link in the navigation on the left of the screen.

Step 6: You will now see your API Access List, for the Row with the name "Benji Pays", copy the value in the Token field, this needs to be copied into the "Helcim API Key" field in the Benji Pays Payment Settings window you have open.

Step 7: Lastly we need to configure Helcim.js - this is the magic that allows us to safely add your customers' cards into Helcim without them ever touching the Benji Pays servers.

1. Click the "All Tools" again, and then "Integrations"
2. Click the "Helcim.Js Integrations" link 
3. Click the "New Configuration" button in the top right hand side of the screen that loads.
4. In the form that opens, enter as per below
5. IMPORTANT: Ensure Transaction type is set to Card Verify (Tokenize Only)
6. Click the save button in the top right corner of the screen.
7. Click the "Helcim.Js Configurations" link on the navigation in the left of the screen.
8. You will now see your configuration listed in the middle of the screen, copy the token on the Row named Benji Pays and paste it into the "Helcim.js token" field Benji Pays Payment Gateway Settings window.

IMPORTANT: Ensure the Transaction Type is set to Card Verify (Tokenize Only) in your Helcim.js configuration above. 
 
  If this is field is set to another type, you may get errors when adding payment profiles (Tokenization Error) or a "Missing Amount" error when making a payment on your pay now pages.

Step 8: Click the Save Gateway button. Your gateway is now configured. Before enabling your Auto Processing in your Company Settings, add a customer Profile in Benji Pays and then go to the Manual Processing page and process an invoice payment for the profile you created in order to test that your Gateway is setup correctly.