You are currently viewing the documentation for version


Introducing the Revolutionary Handpoint JavaScript SDK: Seamlessly integrate card present payments into any cloud software

Use the Handpoint JavaScript SDK to integrate leading smartpos terminals with your cloud software. The Handpoint JavaScript SDK is a simple javascript interface running in your web application that acts as a bridge between the web browser and the payment terminal, while shielding your software from card data. It is seamless to integrate, keeps all card data out of your system, works with every platform, and lets you use the best Android terminals on the market.

Complete your integration in just three steps: Initiate the interface, choose the terminal, and start the sale. It is as simple as it sounds. The only thing you need is a valid API key to initialize the SDK. You even get a list of terminals to which you can connect. Simply execute the operation, and within seconds you’ll get back the transaction result and receipt in your software all while you monitor the transaction status. The Handpoint JavaScript SDK seamlessly starts and manages the entire P2PE transaction with the payment terminal, minimizing hassle for you and maximizing reliability, security, and control.

For your merchants, the terminal setup is easier than a standalone. A merchant connects the terminal to their network, just like a smartphone, authenticates his/her account, and it simply works -- your software then control the terminal from anywhere in the world, and your merchants have secure, reliable, intuitive payments.

version 6.1.0

Get the SDK

Release Notes



  • MoTo


  • Duplications on recovered transactions



  • Internal variable handling



  • The recovery function in the init method was added to make sure that ALL transaction results are received by the POS, even in case of an unstable network connection. The recovery function passed as third parameter in the init method MUST return a promise. The resolution of the promise will send a message to the payment terminal acknowledging the reception of the transaction result.

API Overview

This API flow shows how easy it is to add card present payments to your cloud application. The interaction between your cloud application and the Handpoint JavaScript SDK is simple and streamlined. The Handpoint JavaScript SDK takes care of all of the communication with the terminal. The status messages are received in the WEB APP via the callback function defined in the Financial Operation requests call. That’s it.

The Handpoint JavaScript SDK shields your software from all sensitive cardholder data. With Handpoint JavaScript SDK, the transaction request goes from your software to Handpoint in the cloud. We steer the terminal from the cloud. All of the results come to your software via Handpoint in the cloud.


Getting started with the SDK is fast and easy. Simply download the Javascript SDK from here. Request a valid API key to start using the SDK and all of its functionalities. Initialize the SDK with your API key and receive the list of devices available to perform the sale.


Get started today with our sandbox. You can generate sample transactions and test the experience right in your browser. Check it at: A payment terminal is required to start testing.

This is the initial setup screen:

To get started, select the target environment where you are going to operate (Sandbox/Production). If the user has any doubts selecting the correct environment, click on "*How do I know what type of card reader do I have?" and you will be redirected to an explanation page.