Helcim Logo Support & Tutorials

© Copyright 2006-2019 Helcim Inc.

All Rights Reserved.

Helcim.js » Legacy Helcim.js 1.0 »

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.

HTML Example

<script type="text/javascript" src="https://gateway.helcim.com/js/version1.js"></script>

<form name="helcimForm" id="helcimForm" action="your-checkout-page.php" method="POST">

	<div id="helcimResults"></div><br/>

	<input type="hidden" id="merchantId" value="9999123456">

	Credit Card Number: <input type="text" id="cardNumber" value="5454545454545454"><br/>
	Expiry Date: <input type="text" id="expiryDate" value="1019"><br/>
	CVV: <input type="text" id="cvv" value="100"><br/>

	<input type="button" id="buttonProcess" value="Process Payment" onclick="javascript:helcimProcess();">