Helcim Logo Support & Tutorials

© Copyright 2006-2018 Helcim Inc.

All Rights Reserved.

Helcim Commerce API » Processing Payments » Card Payments »

Request Fields

IMPORTANT: Request Fields for the credit card payments API's.

General Fields

Field Name Type Required Description
transactionType String Yes The type of transaction. Purchase.
accountId String Yes The Helcim Commerce account ID.
apiToken String Yes API token used for authentication and access control. 
amount Decimal No The transaction amount. Not required if Helcim Commerce is being used to verify a credit card or settle a batch.
terminalId Integer No  The terminal ID.  If it is not entered the merchant's default terminal will be used.
currency String No The currency of the terminal.

Full Credit Card Number Fields

Field Name Type Required Description
cardNumber Integer Yes The credit card number; must not include any spaces or special characters.
cardExpiry Integer Yes The credit card expiry, format: MMYY.
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).

Credit Card Token Fields

Field Name Type Required Description
cardToken String No The credit card token. (Required when processing a transaction with the credit card token)
cardF4L4 String No The first 4 and last 4 digits of the credit card number. (Required when processing a transaction with the credit card token)

Magnetic Stripe Data Fields

Field Name Type Required Description
cardMag String Yes Credit card magnetic strip data.
serialNumber String Yes The terminal serial number.
cardMagEnc String Yes Credit card magnetic strip encrypted data.

Customer Code

Field Name Type Required Description
customerCode String No The customer code.  Required when processing a transaction with a card token. 

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 Fields

Field Name Type Required Description
amountShipping Decimal No The shipping cost.
amountTax Decimal No The tax amount.
shippingMethod String No The method of shipping.
taxDetails String No The tax name.

Order Item(s) Fields

Field Name Type Required Description
Order Information
NOTICE: For all item variables replace "#" with a unique item number (starting at 1, and increasing by 1 for each unique item added).
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.

Code Samples

General Fields HTML Sample HTML

<input type="hidden" id="transactionType" value="Purchase">
<input type="hidden" id="accountId" value="YOUR-ACCOUNT-ID">
<input type="hidden" id="apiToken" value="YOUR-API-TOKEN">
<input type="hidden" id="amount" value="100.00">
<input type="hidden" id="terminalId" value="YOUR-TERMINAL-ID">
<input type="hidden" id="currency" value="CAD">

Full Credit Card Number Fields HTML Sample HTML

<input type="hidden" id="cardNumber" value="5454545454545454">
<input type="hidden" id="cardExpiry" value="1025">
<input type="hidden" id="cardCVV" value="100">
<input type="hidden" id="cardHolderName" value="Jane Smith">
<input type="hidden" id="cardHolderAddress" value="123 Street South">
<input type="hidden" id="cardHolderPostalCode" value="90210">

Credit Card Token Fields HTML Response HTML

<input type="hidden" id="cardToken" value="6dc57d55b60fce3f9c6a5d">
<input type="hidden" id="cardF4L4" value="54545454">

Magnetic Stripe Data Fields HTML Sample HTML

<input type="hidden" id="cardMag" value="%B5472063333333330^ELAVONTEST/TESTCARD^19129015432139614567891234567890011223?;5472063333333330=19129015432139614567? //">
<input type="hidden" id="serialNumber" value="653432780671ffffffffffffff93">
<input type="hidden" id="cardMagEnc" value="0c3a6077d67812d37acc072afbf7729053f60dd84b6a99017c09c7b71231867ca08dd6aa6185577911113d97e09c24e32acf48c96982c61ce208db732b831173ef507d20f5801a12cc49be8b11e1eaa7bfa7729cd2867a4e7870c08dccdb610e113a0e44fd5430afce582a6c02f2bbed0948933d0a64d4fb">

Customer Code Field HTML Sample HTML

<input type="hidden" id="customerCode" value="CST1000">

Billing and Shipping Fields HTML Sample HTML

<input type="hidden" id="billing_contactName" value="Jane Smith">
<input type="hidden" id="billing_businessName" value="ABC Business">
<input type="hidden" id="billing_street1" value="303 Avenue North">
<input type="hidden" id="billing_street2" value="Unit 1403">
<input type="hidden" id="billing_city" value="Calgary">
<input type="hidden" id="billing_province" value="Alberta">
<input type="hidden" id="billing_country" value="Canada">
<input type="hidden" id="billing_postalCode" value="T2H 1K7">
<input type="hidden" id="billing_phone" value="403-555-1234">
<input type="hidden" id="billing_fax" value="403-555-2233">
<input type="hidden" id="billing_email" value="jane@example.com">
<input type="hidden" id="shipping_contactName" value="John Smith">
<input type="hidden" id="shipping_businessName" value="ABC Business USA">
<input type="hidden" id="shipping_street1" value="400 Street West">
<input type="hidden" id="shipping_street2" value="Unit 12">
<input type="hidden" id="shipping_city" value="Seattle">
<input type="hidden" id="shipping_province" value="WA">
<input type="hidden" id="shipping_country" value="USA">
<input type="hidden" id="shipping_postalCode" value="90221">
<input type="hidden" id="shipping_phone" value="814-555-1233">
<input type="hidden" id="shipping_fax" value="814-555-6633">
<input type="hidden" id="shipping_email" value="john@example.com">

Order Fields HTML Response Code

<input type="hidden" name="amountShipping" value="4.95">
<input type="hidden" name="amountTax" value="1.50">
<input type="hidden" name="shippingMethod" value="UPS">
<input type="hidden" name="taxDetails" value="10% Tax">

Order Item(s) Fields HTML Response HTML

<input type="hidden" id="itemSKU1" value="SKU123">
<input type="hidden" id="itemDescription1" value="The First Item">
<input type="hidden" id="itemSerialNumber1" value="SN109102991">
<input type="hidden" id="itemQuantity1" value="2.00">
<input type="hidden" id="itemPrice1" value="5.00">
<input type="hidden" id="itemTotal1" value="10.00">

<input type="hidden" id="itemSKU2" value="SKU456">
<input type="hidden" id="itemDescription2" value="The Second Item">
<input type="hidden" id="itemSerialNumber2" value="SN1091209310293">
<input type="hidden" id="itemQuantity2" value="1.00">
<input type="hidden" id="itemPrice2" value="17.00">
<input type="hidden" id="itemTotal2" value="17.00">