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 Type

Element ID

Format

Description

script

text/javascript

The Helcim.js JavaScript. Should be src="https://secure.myhelcim.com/js/version2.js"

form

helcimForm

method="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.

div

helcimResults

Empty

This 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 hidden

token

String

Your Helcim.js configuration token. This is used to identify your account and configuration settings.

input hidden

language

String

The language for error message. Default is "en" for English.

input hidden

test

Integer

Set to "1" for test-mode.

input text

cardNumber
cardExpiry
etc. (see below)

The input fields. Please refer to documentation here.

input button

buttonProcess

onclick="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.


Did this page help you?