Helcim Logo Support & Tutorials

© Copyright 2006-2018 Helcim Inc.

All Rights Reserved.

Legacy Platforms » Helcim Virtual Terminal » Hosted Payment Pages »

Sending Data to a Hosted Payment Page

Our Hosted Payment Pages can receive data through either GET or POST (you can use the method that best fits your development needs). The variables themselves are essentially the same as the ones used for the Payment Gateway API, minus the credit card information. Once a transaction is approved, you can also program your website to Receiving Approval Data from the Page. Sending data to the payment field can be as simple as creating a URL with extra GET data, such as a preset amount and order (invoice) number:

https://gateway.helcim.com/hosted/?merchantId=YOUR-ACCOUNT-ID&token=YOUR-UNIQUE-PAGE-TOKEN&amount=100.00&orderId=INV1234

If you are using the test gateway you will need to change the URL in your request:

https://gateway.qa.helcim.com/hosted/?merchantId=YOUR-ACCOUNT-ID&token=YOUR-UNIQUE-PAGE-TOKEN&amount=100.00&orderId=INV1234

All of the fields below are optional except for the merchantId and token needed to generate the page.

<form action="https://gateway.helcim.com/hosted/" method="POST">
<!-- Basic 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">

<!-- 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>