Skip to main content (Press Enter)
Helcim Logo
Click here if you return to contents

Request Fields

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.


General Fields

Field Name Type Required Description
token String Yes The Helcim.js configuration token.
language String No The language to display error messages in. English is default.
test Integer No Set to "1" for test-mode. The Helcim.js configuration must also be set to test-mode.
amount Decimal No The transaction amount. Not required if Helcim.js is being used to tokenize credit card or bank account.
amountHash String No * The hashed amount. *Required if Helcim.js configuration requires hashing protection.
amountShipping Decimal No The order's shipping amount.
amountTax Decimal No The order's tax amount.
amountDiscount Decimal No The order's discount amount.
customerCode String No The customer code. Sending this will link the order and tokenized card to this customer.
orderNumber String No The order number. Sending this will link transaction to this order.
comments String No The order comments.
g-recaptcha-response String No* The response received from Google for ReCaptcha. *This is required if ReCaptcha is enabled in the .JS config.

Credit Card Fields

Field Name Type Required Description
cardToken String Yes The credit card token. Used if updating an existing credit card.
cardNumber Integer Yes The credit card number; must not include any spaces or special characters.
cardExpiry Integer Yes The credit card expiry, format: MMYY - Merchant can send either this field, or the individual cardExpiryMonth and cardExpiryYear fields.
cardExpiryMonth Integer Yes * The credit card expiry month, format: MM
cardExpiryYear Integer Yes * The credit card expiry year, format: YY or YYYY
cardCVV Integer Yes * The credit card security code (CVV/CVC). Can be 3 or 4 digits.
cardHolderName String No The cardholder name.
cardHolderAddress String No The cardholder address (used for AVS).
cardHolderPostalCode String No The cardholder postal code (used for AVS).

Bank Account (EFT/ACH) Fields

Field Name Type Required Description
bankAccountToken String Yes The bank account token. Used if updating an existing bank account.
bankAccountType String Yes The bank account type. Must be "CHK" for checking/chequing or "SAV" for saving account.
bankAccountCorporate String Yes Must be "P" for personal, or "C" for corporate.
bankTransitNumber Integer Yes The bank account transit number. Must be 9-digits (USA) or 5-digits (Canada)
bankAccountNumber Integer Yes The bank account number - Must be at least 6-digits
bankFirstName String Yes The bank account holder's first name.
bankLastName String Yes The bank account holder's last name.
bankCompanyName String No The bank account holder's company name.
bankStreetAddress String Yes The bank account holder's street address.
bankCity String Yes The bank account holder's city.
bankProvince String Yes The bank account holder's state or province.
bankCountry String Yes The bank account holder's country.
bankPostalCode String Yes The bank account holder's zip or postal code.

Billing and Shipping Information

These fields can be used to set the customer's billing and shipping information, as well as the order's billing and shipping information.

Field Name Type Required Description
billing_contactName String No The the billing address contact name.
billing_businessName String No The billing address business name.
billing_street1 String No The billing street address.
billing_street2 String No The billing street address.
billing_city String No The billing city.
billing_province String No The billing province.
billing_country String No The billing country.
billing_postalCode String No The billing postal code.
billing_phone String No The billing phone number.
billing_fax String No The billing fax number
billing_email String No The billing email.
shipping_contactName String No The shipping contact name.
shipping_businessName String No The shipping business name.
shipping_street1 String No The shipping street address.
shipping_street2 String No The shipping street address.
shipping_city String No The shipping city.
shipping_province String No The shipping province.
shipping_country String No The shipping country.
shipping_postalCode String No The shipping postal code.
shipping_phone String No The shipping phone number.
shipping_fax String No The shipping fax number.
shipping_email String No The shipping email address.

Order Item(s) Fields

For all item variables replace "#" with a unique item number (starting at 1, and increasing by 1 for each unique item added).

Field Name Type Required Description
itemSKU# Integer No The sku.
itemDescription# String No The item description.
itemSerialNumber# String No The item serial number.
itemQuantity# Decimal No Item quantity, must be at least one for item to be added.
itemPrice# Decimal No The item price.
itemTotal# Decimal No The item price x the quantity.

Related Articles

An Overview of Helcim.js
Creating a New Helcim.js Configuration
Editing or Deleting a Helcim.js Configuration
Using the Helcim.js Code Generator
Response Fields
HTML Structure
SSL, Security and Hashing

Was this article helpful?

Feedback submitted - Thank you!
Click here if you return to the content