Skip to main content (Press Enter)
Helcim Logo
Click here if you return to contents

API Errors

Below is a list of the potential errors and associated description you may encounter while using the Helcim API and Helcim.js

All API Interactions

Error Message Description
Invalid API Token1 The API token passed in the request does not match the API token set for the online store domain.
Invalid API Token2 The API token passed in the request does not match any API Access entries and the online store is not enabled.
Account Not Active The commerce a count status is not set to active.
Missing or Invalid Fields - Account ID The account id does not match any existing commerce accounts.
Missing or Invalid Fields - Account ID or API Token Either the account id or the api token were not passed in the request.
Invalid Action Requested No action or transaction type was passed in request.
API Access Disabled The commerce account api feature has not been activated.

Gateway (Includes anything with transactionType post)

Error Message Description
SYSTEM ABUSE DETECTED (AD1) - CONTACT TECH SUPPORT Card testing behaviour has been detected without the test property being passed in the request.
Invalid Amount When type is purchase, preauth or refund, and the amount passed is less than or equal to zero.
This transaction cannot be voided. To be voided the original transaction must be approved, of type purchase, capture or refund, not already voided or reversed and be in an open batch.
Invalid Transaction ID The transaction id does not match one of the merchant’s transactions.
This transaction cannot be captured. To be captured the original transaction must be approved, of type preauth, not voided, reversed or already captured, and the amount to capture must be less than or equal to the original preauth amount.
Restricted User Access A transaction type was passed that either does not exist or the user does not have the required permissions to access.
Restricted Terminal Access User does not have access to the terminal set for this integration.
Currency is not supported in Commerce - [currency] The currency passed in the request is not set up in the merchant’s commerce account.
Currency is not found in Commerce - [currency] The currency passed in the request is not available in Commerce.
Card Token Belongs to Another Customer ID' and 'Card Token Does Not Match Customer Code There is a discrepancy between the card token and the customer code. Either the customer does not exist or does not belong to the merchant, it is not linked to the card tied to that card token.
Card F4L4 Does Not Match Card Token The card that was is linked to the card token passed in the request has first four and last four digits that do not match the F4L4 passed on the request.
Invalid Card Token The card token passed in the request does not match a card tied to the merchant account.
Invalid Field - Card Mag Data The card mag data passed in the request cannot be parsed correctly.
Device has been deactivated - Cannot decrypt data The reader device tied to the serial number passed in the request is not active.
Invalid Device Serial Number The serial number passed in the request does not match a reader device belonging to the merchant account.
No Card-On-File for Customer The customer pulled based on the request does not have a default card, and no other payment methods were supplied.
Invalid Field - Expiry Date. The expiry date request field is formatted incorrectly.
Card Has Expired. The expiry date request field reflects a past date.
Invalid Credit Card Number (Lunh Check). The card number request field doesn’t meet the Luhn Check requirements.
Missing Card CVV No CVV request field was passed.
Missing Cardholder Name No cardholder name request field was passed.
Missing Cardholder Address No cardholder address request field was passed.
Missing Cardholder Postal Code No cardholder postal code request field was passed.
Sending Full Card Number Is Not Allowed Only Helcim Users and accounts with expressed permission can send full card numbers.
API Gateway Processing Access Disabled The commerce account gateway api feature has not been activated.

batchEFTView

Error Message Description
Batch Not Found The batch number and the terminal id passed in the request did not match a merchant batch.
Invalid Batch Number or Terminal ID Either a batch number or a terminal id was not passed in the request.
Restricted User Access The user does not have permission to view transactions.

batchView

Error Message Description
Invalid Batch Number or Terminal ID The batch number and the terminal id passed in the request did not match a merchant batch. This includes one or the other of the fields not being passed in the request.
Restricted User Access The user does not have permission to view transactions.

brandsView

Error Message Description
Invalid Brand ID The brand id was either not passed or it did not match a merchant brand.
Restricted User Access The user does not have permission to view products or the online store.

Helcim.js

Error Message Description
YOUR BROWSER IS NOT SUPPORTED The browser does not support cross site data.
HELCIM REQUIRED FIELDS MISSING: [field] The listed fields are required and have not been passed.
INVALID HELCIM.JS TOKEN No token was passed.
INVALID CUSTOMER CODE A bank account was passed without a customer code being provided.
INVALID CREDIT CARD NUMBER Either a credit card wasn’t passed or did not match a valid credit card pattern.
INVALID CREDIT CARD EXPIRY Either a credit card expiration wasn’t passed, it was more or less than 4 digits or it contained non-numeric characters.
INVALID CREDIT CARD CVV Either a cvv wasn’t passed, it was more or less than 3-4 digits or it contained non-numeric characters.
BROWSER SSL CERTIFICATE MISSING No SSL connection e.g. http: instead of https: (doesn’t apply in test mode)
ERROR: NO RESPONSE DATA Something went wrong with the construction of the XML response. Could be the result of any process-stopping errors.
reCaptcha Failed - Please Try Again Recapchta is required and the recaptcha token was either not passed or the score was below the minimum required. The score and the required toggle are settings in the JS config page.
'Invalid Helcim.js Token No token was passed, no JS Config tied to the token exists or the JS Config is not active.
Invalid Merchant ID Merchant either doesn’t exist or is inactive.
Invalid Terminal ID in Helcim.js Config The terminal id tied to the JS Config is either tied to a terminal that doesn’t exist or doesn’t belong to the merchant.
Test Mode Disabled in Helcim.js Config Test prop was passed but JS Config isn’t set up to allow test mode.
SYSTEM ABUSE DETECTED (AD1) - CONTACT TECH SUPPORT Card testing behaviour has been detected without the test property being passed in the request.

EFT

Error Message Description
Invalid Field - Bank Account Type (CHK or SAV) bankAccountType is not set as CHK or SAV
Invalid Field - Bank Account Corporate Type (P or C) bankAccountCorporate is not set as P or C
Invalid Field - Bank Transit Number bankTransitNumber is empty
Invalid Field - Bank Account Number bankAccountNumber is empty
Invalid Field - First Name bankFirstName is empty
Invalid Field - Last Name bankLastName is empty
Invalid Field - Company Name bankCompanyName is empty
Invalid Field - Street Address bankStreetAddress is empty
Invalid Field - City bankCity is empty
Invalid Field - Province bankProvince is empty
Invalid Field - Country bankCountry is empty
Invalid Field - Postal Code bankPostalCode is empty
Invalid Transit Number - Must be 9-digits (USA) or 5-digits (Canada) bankTransitNumber is not 9 or 5 digits long
Invalid Bank Account Number - Must be at least 6-digits bankAccountNumber is less than 6 digits long
Invalid Customer Code Customer code passed does not match one of the merchant’s customers
Bank Account Does Not Belong to Customer Bank account token passed is not tied to a bank account linked to the customer data
Invalid Bank Account Token Bank account token does not match any bank accounts tied to the merchant account

Credit Card

Error Message Description
Missing Cardholder Name cardHolderName is empty
Missing Cardholder Address cardHolderAddress is empty
Missing Cardholder Postal Code cardHolderPostalCode is empty
Invalid Card Number (Luhn Check Failed) The card number posted didn’t meet the Luhn Check credit card pattern requirements
Invalid Card Expiry The expiry date request field is formatted incorrectly.
Card Has Expired The expiry date request field reflects a past date.
Invalid CVV Either a cvv wasn’t passed, it was more or less than 3-4 digits or it contained non-numeric characters.
Purchase/PreAuth Error Message Description
Customer Code Does Not Match Order Number The order tied to the order number passed does not match the customer tied to the customer code passed.
Order Number Does not Match Terminal Currency The order tied to the order number passed has a different currency than the terminal tied to the JS Config.
Order Number Already Marked as Paid The status of the order tied to the order number passed is not Due.
Hash Amount Incorrect The hashing enforcement setting is on in the JS config and the posted amount hash does not match the posted amount when it’s hashed
Amount Above Maximum Amount The amount maximum is set to greater than zero in the JS config and the posted amount exceeds that max.
Amount Below Minimum Amount Amount posted is less than the minimum amount set in the JS config
Missing Amount Amount posted is less than or equal to zero
Verify Error Message Description
Cards Does Not Belong to Customer The card tied to the card token passed does not match the customer tied to the customer code passed
Invalid Card Token The card tied to the card token passed either doesn’t exist or is not tied to the merchant account
Invalid Transaction Type The transaction type set in the JS Config does not match Purchase, Preauth or Verify
Duplicate Payment Request fully matches that of an existing approved transaction that has not been voided or settled yet.

Related Articles

How to Find Your Account ID
Sending Full Card Numbers Through the Helcim API

Was this article helpful?

Feedback submitted - Thank you!

If you need immediate assistance please contact the Helcim Gurus here