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.