Overview of HelcimPay.js

Embed payments into your website without handling sensitive information, with a single API call. HelcimPay.js is the ideal solution for developers looking to implement a seamless experience while reducing security and PCI-DSS scope.

With our prebuilt payment modal, HelcimPay.js enables you to easily accept payments without facing the typical security drawbacks of using payment gateway integrations.

Technical Overview

  • HelcimPay.js is a payment processing tool that can be easily set up with a single API call (please refer to the dev docs for more details).
  • The HelcimPay.js modal can be easily implemented by adding a script tag to your web browser’s HTML code (please refer to the Implementation section for more details).

Using your access token to establish an API connection ensures a secure connection between your server and Helcim. With a successful request, a checkout token and a secret token are returned.

The checkout token is the key to the HelcimPay.js modal. This token ensures a secure connection between the cardholder’s web browser and Helcim’s endpoint. Please note, the checkout token is a unique value for each payment instance, and it expires after 60 minutes, or once the transaction is processed. Having unique and recent checkout tokens reduces the likelihood that an unauthorized payment is processed.

The secret token is used for verification after a transaction has been processed successfully. This token, along with transaction data in the response are used to create a hash. You can use this to verify that the data in the transaction response is valid and has not been tampered with.

Transaction Flow

The steps below outline the transaction flow through HelcimPay.js

  1. A customer clicks on a button [configured with the checkoutToken] that displays the HelcimPay.js modal.
  2. A customer enters their card information, or if a customer code is provided in the initialization process, selects an existing card tied to their account.
  3. Customer clicks on the “Process Payment” button.
  4. The required payload for a transaction is received and processed.
  5. When the transaction is successful, a payload is returned to you and an approval message is displayed.

Get started with HelcimPay.js by creating an API access token.