HTML form structure

Once the transaction is completed and the form is submitted, POST data will be sent back to the merchant's server (webpage). The POST data will include the fields listed below. The POST field [xml] will also contain an XML structure of the response.

HTML Element TypeElement IDFormatDescription
script-text/javascriptThe Helcim.js JavaScript. Should be src="https://secure.myhelcim.com/js/version2.js"
formhelcimFormmethod="POST"The HTML form. Once the transaction is complete, Helcim.js will submit the form back to the merchant server (website) to capture the transaction results.
divhelcimResultsEmptyThis DIV content will be overwritten by Helcim.js - it will display errors as well as the transaction results before the form is finally submitted.
input hiddentokenStringYour Helcim.js configuration token. This is used to identify your account and configuration settings.
input hiddenlanguageStringThe language for error message. Default is "en" for English.
input hiddentestIntegerSet to "1" for test-mode.
input textcardNumber
cardExpiry
etc. (see below)
-The input fields. Please refer to documentation here.
input buttonbuttonProcessonclick="javascript:helcimProcess();"The input button to process the payment. The value can be set to anything, such as "Process Payment" or "Save Card".

❗️

IMPORTANT

Fields with sensitive credit card information should not have an HTML field name, only an HTML field "id". This will allow the JavaScript to retrieve the values (getElementById), but prevent the fields from being submitted back to the merchant server. Helcim.js will also attempt to mask sensitive data before submitting form.