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.
Updated 9 months ago