Skip to main content

SmartPOS API Overview

The SmartPOS API is an abstraction layer that provides developers with access to the features and capabilities of SmartPOS devices, which are specialized Android-based devices designed for payment processing and related applications.

SmartPOS API Overview

Why Should You Use SmartPOS API?

Compared to standard Android devices, SmartPOS devices have a number of additional features and capabilities that make them well-suited for use in payment processing and related applications:

Built-in Printer

Access to the integrated hardware printer for receipts and documents

Security Interface

Ensure confidentiality and integrity of data exchanged between your application and the device

Card Readers

Access to contactless and contact card readers for non-payment use cases in your application

Device Information

Access device-specific information for analysis or customizing user experience

How to Use SmartPOS API?

The SmartPOS API is an Android service that can be integrated into any Business application. It provides access to a range of hardware features and capabilities that are specific to SmartPOS devices, including NFC reading/writing, printers and more. It also provides access to system information, which is essential for ensuring the security and confidentiality of sensitive information.

To use the SmartPOS API, developers need to:

1
Obtain a SmartPOS Device

Get a SmartPOS device from Worldline for development and testing

2
Add the Library

Integrate the SmartPOS API library into your Android application

3
Connect to the Service

Bind to the SmartPOS API service using Android's AIDL interface

4
Use the Features

Access hardware features like printer, NFC, and security services

Read Full SmartPOS API Specification
Complete API reference with all methods and code examples

Where Can You Use SmartPOS API?

SmartPOS API is currently available on the following devices offered by Worldline:

DeviceModel
Ingenico VALINAAndroid SmartPOS terminal
Castles Saturn 1000F2S1F2
Castles Saturn 1000UPT2S1U2
Castles Saturn 1000PS1P

API Interfaces

The SmartPOS API provides several interfaces for different functionality:

InterfaceDescription
SmartPOS InfoAccess generic information about the SmartPOS device for analysis, reporting, or customizing user experience
SecurityEstablish secure connections with compliant cipher suites for confidential data exchange
PrinterInteract with the hardware printer for receipts and documents
NFC ReaderRead and write to MIFARE and FELICA chip cards using NFC technology
ChipCard ReaderRead Belgium eID cards
Feature CheckValidate supported features of the SmartPOS device
For payment processing, use the [WPI (Worldline Payment Interface)](/smartpos/wpi/index). SmartPOS API is complementary to WPI for non-payment related terminal interactions.