Introduction

This document describes the integration of the CliSiTef library with the Android operating system. CliSiTef provides the client application with the interface with the payment method services available on the SiTef server. For a complete understanding of the interaction of the Commercial Automation application with CliSiTef, a prerequisite is full mastery of the SiTef access interface via DLL described in the document “SiTef - Interface Simplificada com a aplicação.pdf”.

CliSiTef for Android can be integrated with applications developed for three different hardware scenarios:

  1. Android Smartphone/Tablet together with external PinPad (two different devices connected via USB or Bluetooth). Example: Samsung smartphone with PAX D200 pinpad.
  2. APOS terminal with fixed external pinpad (a single device comprising an Android tablet, external pinpad attached to the tablet, thermal printer and other peripherals). Example: Verifone Carbon 10.
  3. APOS terminal with internal pinpad (a single device comprising Android smartphone, internal pinpad, thermal printer and other peripherals).Examples: Gertec GPOS700 and Ingenico A8.

As all Scenarios are Android, the form of integration is essentially the same. In other words, the flow of calls to CliSiTef will be practically identical in the three Scenarios. The small differences are caused by the fact Scenarios 1 and 2 use an external pinpad and Scenario 3 uses an internal pinpad, which shares the screen with the application. Therefore, it is important that developers in Scenario 3 carefully read Section 7 specific to APOS with internal pinpad. For integration in Scenarios 2 and 3, as they already have an internal or externally coupled pinpad, developers can disregard the sections of this document referring to the external USB/Bluetooth PinPad (Section 6).

At the time of publication of this document, several models of APOS terminals are in the process of approval with acquiring networks. For these cases, Software Express provides versions of CliSiTef for development or pilot purposes only. Consult us about availability for each platform.