Card payments. Made simple.

Start developing with the Handpoint SDKs!

Step 1. Choose your SDK

High level features supported by the SDKs:

The Handpoint SDKs provide you with several functions to communicate with the payment terminals:
  • Sale operation - It starts a purchase transaction on the payment terminal. In its simplest form you only have to pass the transaction amount and currency as parameters.
  • Sale and tokenize operation - A sale operation which also returns a card token (not available for all acquirers, please check with Handpoint to know if tokenization is supported for your acquirer of choice)
  • Tokenize operation - Returns a card token representing the PAN of the card (not available for all acquirers, please check with Handpoint to know if tokenization is supported for your acquirer of choice)
  • Refund operation - It starts a refund transaction on the payment terminal. This operation moves funds from the merchant account to the cardholder's payment card.
  • Sale reversal operation - Allows the merchant to reverse a previously approved sale operation.
  • Refund reversal operation - Allows the merchant to reverse a previously approved refund operation.
  • Card pan operation - A cardPan request will return the full PAN of the card being swiped, dipped or tapped. Only the PANs of whitelisted card ranges will be returned by the Handpoint systems. This operation is mostly used to be able to process funds or points from loyalty card.
  • Update operation - Allows the merchant to search for the latest software updates on the terminal.
  • Print receipt operation - This method sends the merchant or customer receipt to the terminal for printing. The printer can print any HTML data passed as parameter.
  • Ping operation - This operation will ping the terminal to confirm if it is online.
  • Stop current transaction operation - Operation used to stop the current transaction. The transaction can only be stopped at specific stages of a payment processing, for example a transaction can not be stopped when the card is being read but can be stopped when waiting for the cardholder to initially insert a card.
Status messages are sent back to the SDK throughout the transaction process so you can customize the checkout experience. At the end of the transaction, the result and receipts of the transaction are sent back to your application in a JSON format.
No cardholder data is transmitted to your POS so you can be kept out of scope of the PCI data security standard.

Payment terminals supported by SDK:

Android SDK iOS SDK Windows SDK Cordova SDK Express SDK Javascript SDK REST API Xamarin SDK
HiLite - -
HiPro - - - - -
Hi5 - -
PAX A920 - -
PAX A920 Pro - -
PAX A60 - -
PAX A77 - -
PAX A80 - -
Telpo TPS900 - -
- Written in native Java and Kotlin
- Available through Maven Central
- Min api version 22
- Target api version 29
- JDK 1.8
- Written in Objective-C
- Available through Cocoapods and Carthage
- Min iOS deployment version 8.0
- iOS deployment target version 8.0
- Written in csharp
- Available through NuGet
- .Net Framework Version 4.6.1
- Version >=3.0.0
- Compatible with Android and iOS
- HiLite, HiPro or Hi5 terminals are your preferred form factors.
- Lightweight integration
- Important Note: The Express app must be installed on the merchants device (computer/tablet/phone).
- ECMAScript 6
- Enables remote control of Android based terminals like PAX or Telpo.
- Searching for a quick, simple and tremendously flexible integration, this is your choice - Xamarin SDK maintained by the community of Handpoint developers.

Step 2. Check your terminal specs:

Terminal full specifications:

Communication types:

Lightning Bluetooth Ethernet Mobile Network Wifi
HiLite - - - -
HiPro - - - -
Hi5 - - (2G) -
PAX A920 - - - (4G/LTE)
PAX A920 Pro - - - (4G/LTE)
PAX A60 - - - (4G/LTE)
PAX A77 - - - (4G/LTE)
PAX A80 - - (4G/LTE)
Telpo TPS900 - - - (4G)

Step 3. Choose your payment processor(s)

Solutions by processor

TSYS
(US & CN)
Worldpay
(US)
EVO
(US & EU)
Borgun
(EU)
Lloyds
(EU)
eMerchantPay
(EU)
Paystrax
(EU)
SureSwipe
(SAf)
NRT Technology
(CN)
Paysafe
(US, CN & EU)
OmniPay
(EU)
Amex Direct
All Regions
HiLite -
HiPro -
Hi5 -
PAX A920 - - -
PAX A920 Pro - - -
PAX A60 - - -
PAX A77 - - -
PAX A80 - - -
Telpo TPS900 - - - - - - - -

By features supported:

TSYS
(US & CN)
Worldpay
(US)
EVO
(US & EU)
Borgun
(EU)
Lloyds
(EU)
eMerchantPay
(EU)
Paystrax
(EU)
SureSwipe
(South Africa)
NRT Technology
(CN)
Paysafe
(US, CN & EU)
OmniPay
(EU)
Amex Direct
All Regions
Card brands supported Mastercard
VISA
Discover
Amex
Diners
JCB
Mastercard
VISA
Discover
Amex
Mastercard
VISA
Discover (US only)
Amex (US only)
Mastercard
VISA
Diners
JCB
Amex (IS only)
Mastercard
VISA
Diners
JCB
Amex
Mastercard
VISA
Amex
Mastercard
VISA
Amex
Mastercard
VISA
Amex
INTERAC Mastercard
VISA
Discover
Amex
INTERAC
Mastercard
VISA
Amex
EMV
(Chip & PIN or Chip & Sign)
Magnetic stripe
Contactless (EU only)
Apple/Android Pay (EU only)
In-line tipping
Tip adjustment - - - - - - - -
Tokenization with sale
Tokenization only
EBT (US specific) - - - - - - - - -

Step 4. Start your integration!

Android

View the SDK

Windows.NET

View the SDK

JavaScript

View the SDK

REST API

View the API

Xamarin SDK (Community)

View the SDK

Express

View the SDK

Cordova Plugin

View the SDK

Help & Support

Looking for something? If you have questions about anything not covered in our documentation, need assistance integrating, or are unsure where to go from here, our developer support team is here to help.