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

Required Fields

This documentation is for the legacy Helcim.js 1.0. New merchants should refer to the Helcim.js version 2 documentation.

Below are the minimum required elements inside the html page in order for Helcim.js to work. The JavaScript will warn users if an element is missing.

Element Type Name ID Format / Options Description
script - - text/javascript The JavaScript include. Should include src="https://gateway.helcim.com/js/version1.js"
form helcimForm helcimForm method="POST" The HTML form. Once the transaction is complete, the JavaScript will submit the form back to the merchant server to capture the transaction results.
div helcimResults helcimResults This DIV will be overwritten by the JavaScript. It will display errors as well as the transaction results before the form is finally submitted.
input hidden none* merchantId numeric Your merchant id; must not include any spaces or special characters.
input text none* cardNumber 16/numeric Credit card number; must not include any spaces or special characters.
input text none* expiryDate 4/numeric Credit card expiry date in the form of MMYY. With leading zeroes if the month or year is only one digit.
input text none* cvv 4/numeric CVV2 value
input button buttonProcess buttonProcess onclick="javascript:helcimProcess();" The input button to process the payment. The value can be set to anything, such as "Process Payment".

IMPORTANT: Fields with sensitive credit card information should not have a field name, only a field ID. This will allow the JavaScript to retrieve the values, but prevent the fields from being submitted back to the merchant server.

Related Articles

Helcim.js Version 1 - How it Works
Optional Fields
Response Values
PHP Code Sample

Was this article helpful?

Feedback submitted - Thank you!
Click here if you return to the content