Overview of Helcim.js

Embed payments into your website or app without handling sensitive information. Helcim.js is the ideal solution for developers looking for control over their user experience while reducing security and PCI-DSS scope.

Simply put, Helcim.js allows you to maintain full control over your server, HTML and customer experience, without the security drawbacks usually associated with typical payment gateway integrations. Customers remain on your website, yet sensitive credit card data is never submitted to your server directly.


Technical overview

Helcim.js is a JavaScript that uses Cross-Origin Resource Sharing (CORS) AJAX to establish a secure connection between the cardholder's web browser and the Helcim API. Once the transaction is complete, Helcim.js submits the HTML form and your website can capture the results in POST (and XML).

Process card transactions or just tokenize cards

Helcim.js can be used to either process transactions or to tokenize credit cards. When used in conjunction with the Helcim Commerce API, you can achieve full control without the liability of storing and transmitting sensitive cardholder data.

Transaction flow

Once embedded into your website, the steps below outline the transaction flow created by Helcim.js

  1. The customer enters their card information directly on your website.

  2. The customer clicks on "Process".

  3. Instead of submitting the form (POST) back to your server immediately, Helcim.js:

    a) Intercepts the submit request.
    b) Retrieves the sensitive cardholder information from the form (using the input field IDs).
    c) Establishes a secure connection between the client's web-browser and the Helcim API.
    d) Processes or tokenizes the credit card information.
    e) Converts the response into hidden input fields on your website's form.
    f) Removes sensitive information from the original credit card input fields.
    g) Submits the form.

  4. Your website receives the form (POST) response, containing the transaction response instead of full card data.

  5. Your website processes the transaction response and displays an approval or error message to the customer.

Getting started

The first step to use Helcim.js is to generate a new script configuration.