Helcim Logo Support & Tutorials

© Copyright 2006-2018 Helcim Inc.

All Rights Reserved.

Legacy Platforms » Helcim Virtual Terminal » Helcim Gateway API » Form Samples (POST) »

Using Optional Fields

Below is sample form for sending (HTTP POST) a transaction to our payment gateway using all optional fields.

<form action="https://gateway.helcim.com/" method="POST">
<!-- Required Fields -->
<input type="hidden" name="merchantId" value="YOUR-MERCHANT-ID">
<input type="hidden" name="token" value="YOUR-GATEWAY-TOKEN">
<input type="hidden" name="type" value="purchase">
<input type="hidden" name="amount" value="18.00">
<input type="hidden" name="cardNumber" value="4242424242424242">
<input type="hidden" name="expiryDate" value="0315">
<input type="hidden" name="cvvIndicator" value="1">
<input type="hidden" name="cvv" value="123">

<!-- Optional Fields -->
<input type="hidden" name="test" value="1">
<input type="hidden" name="cardholderName" value="John Doe">
<input type="hidden" name="cardholderAddress" value ="111 25th Ave">
<input type="hidden" name="cardholderPostalCode" value="T2S3G4">

<!-- Billing Information -->
<input type="hidden" name="billingName" value="Billing Name">
<input type="hidden" name="billingAddress" value="Billing Address">
<input type="hidden" name="billingCity" value="Billing City">
<input type="hidden" name="billingProvince" value="Billing Province">
<input type="hidden" name="billingPostalCode" value="Billing PC">
<input type="hidden" name="billingCountry" value="Billing Country">
<input type="hidden" name="billingPhoneNumber" value="Billing Phone">
<input type="hidden" name="billingEmailAddress" value="example@example.com">

<!-- Shipping Information -->
<input type="hidden" name="shippingName" value="Shipping Name">
<input type="hidden" name="shippingAddress" value="Shipping Address">
<input type="hidden" name="shippingCity" value="Shipping City">
<input type="hidden" name="shippingProvince" value="Shipping Province">
<input type="hidden" name="shippingPostalCode" value="Shipping PC">
<input type="hidden" name="shippingCountry" value="Shipping Country">
<input type="hidden" name="shippingPhoneNumber" value="Shipping Phone">
<input type="hidden" name="shippingEmailAddress" value="example@example.com">

<!-- Order Information -->
<input type="hidden" name="customerId" value="customer1">
<input type="hidden" name="orderId" value="order1">
<input type="hidden" name="comments" value="Order comments.">

<input type="hidden" name="itemId1" value="SKU1">
<input type="hidden" name="itemDescription1" value="Product 1">
<input type="hidden" name="itemQuantity1" value="2">
<input type="hidden" name="itemPrice1" value="5.00">
<input type="hidden" name="itemTotal1" value="10.00">

<input type="hidden" name="itemId2" value="SKU2">
<input type="hidden" name="itemDescription2" value="Product 2">
<input type="hidden" name="itemQuantity2" value="1">
<input type="hidden" name="itemPrice2" value="5.00">
<input type="hidden" name="itemTotal2" value="5.00">

<input type="hidden" name="shippingAmount" value="1.00">
<input type="hidden" name="taxAmount" value="2.00">

<input type="submit" name="submit" value="Submit">
</form>