Processing with Helcim Fee Saver through HelcimPay

Before initializing your HelcimPay.js checkout session with Helcim Fee Saver you will need to enable this service at a global level within your Helcim account first. Follow the instructions below and pass on your credit card processing fees through HelcimPay!

Confirm Invoicing is set to Credit Card and ACH

  1. Log in to your Helcim account.
  2. Go to All Tools and then Settings.
  3. Select ACH Bank Payment Settings under Payments and Plans.
  4. Ensure Enable ACH Bank Payments is toggled on.

Enable ACH Bank payments screen

  1. Ensure ACH Bank Payment Tools has invoicing set to Credit Card and ACH Payment and is toggled on.

ACH bank payments tools

Toggle on Helcim Fee-Saver

  1. Go to All Tools and then Settings.
  2. Select Fee Saver Settings under Payments and Plans.
  3. Toggle the Online Fee-Saver option on.

Helcim Fee Saver toggles

Processing with Fee-Saver through HelcimPay.js.

Now that your Helcim account is configured to process with Fee-Saver, you will need to Initialize your HelcimPay.js checkout session with the appropriate parameters.

In addition to the required body parameters of paymentType, amount, and currency, you will also need to pass the appropriate parameters of paymentMethod as 'cc-ach' and hasConvenienceFee as '1'.

With these parameters included, the HelcimPay.js payment modal will render with the appropriate convenience fee displayed for credit card processing and give customers the options to instead process through ACH payment to avoid that fee.

// Example of a HelcimPay.js Initialize request with Fee-Saver

const options = {
  method: 'POST',
  headers: {
    accept: 'application/json', 
    'content-type': 'application/json', 
    'api-token': 'API_TOKEN'},
  body: JSON.stringify({
    paymentType: 'purchase',
    amount: 100,
    currency: 'CAD',
    paymentMethod: 'cc-ach',
    hasConvenienceFee: 1
  })
};

fetch('https://api.helcim.com/v2/helcim-pay/initialize', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));