NAV

OPIT

Odero POS Integration Toolkit for Developers

Welcome to OPit, the Odero POS Integration Toolkit designed to streamline and enhance the communication between a Windows device (PC, laptop) and an Odero POS terminal. OPit enables developers to send commands such as Payment Requests, Settlements, Reports, and more, directly to the Odero POS terminal over a TCP/IP socket connection. By leveraging this powerful toolkit, developers can seamlessly integrate their Windows applications with Odero POS, unlocking new possibilities for efficient and secure payment processing.

At its core, OPit provides a reliable and secure channel for data exchange between the Windows device and the Odero POS terminal. This communication is facilitated through TCP/IP sockets, allowing for real-time, bidirectional communication over a local network. To ensure a seamless connection, both the Windows device and the Odero POS terminal must be connected to the same router or Wi-Fi network.

With OPit, developers gain full control over the payment flow, enabling them to initiate payment requests from their Windows applications and receive responses from the Odero POS terminal. This integration empowers developers to create custom workflows, tailor the user experience, and incorporate Odero POS functionality seamlessly into their existing applications. Whether you're building a point-of-sale system, a payment gateway, or any other payment-related application, OPit provides the tools you need to connect and communicate effortlessly with Odero POS.

By leveraging the power of OPit, developers can harness the extensive capabilities of Odero POS, such as processing transactions, generating reports, performing settlements, and more, directly from their Windows applications. This seamless integration ensures a cohesive experience for users and eliminates the need for manual data entry or redundant workflows. With OPit, you can empower your users with a unified and efficient payment processing solution, offering a streamlined experience that enhances productivity and accuracy.

In this developer documentation, we will provide you with comprehensive guidance on utilizing OPit to integrate your Windows applications with Odero POS. You'll find detailed instructions, sample code snippets, and best practices to help you make the most of this powerful toolkit. Whether you're a seasoned developer or just getting started, this documentation will serve as your roadmap to successfully integrating OPit and unlocking the full potential of Odero POS in your applications.

We're excited to have you embark on this journey with OPit, and we look forward to witnessing the innovative solutions you'll build with the power of seamless communication between Windows devices and Odero POS terminals. Let's dive in and get started!

Introduction

OPit Lan for Windows is a C++ library which allows for a Windows device (PC, laptop) to send commands (Payment Request, Settlement, Reports etc) to an Odero Pos terminal.
The communication between the two devices is performed through TCP/IP sockets.
Both devices have to be connected to the same router / wifi network.

Please follow the below instructions for setup:

  1. To use OPIT Lan you will need to use static ips for both devices, on the client tablet and the Odero POS terminal, and to have a dedicated router with - potentially - DHCP off (depends on the router)
    Tutorial on how to set up static ip on Windows can be found here
  2. Connect to wifi on the dedicated router on both devices.
  3. The Odero POS terminal must have the ip 192.168.1.1 this is the ip where the client device expects to find the host.
  4. Install app-lan-host-release.apk on the Odero POS terminal and OpitDesktopSampleApp on the Windows device.
  5. Start the OPIT Lan app on the Odero POS terminal.
  6. Start Sample app on windows.
  7. Send payment request.


Below you can find the OPit Lan for Windows diagram.

  1. OPit lan host on Odero POS terminal is started and the socket server is booted up.
  2. Client app (that implement OPit library) starts on windows device and connects to the socket server from the Odero POS terminal.
  3. Client app receives onConnected callback.
  4. Client app sends payment request via opened tcp/ip socket and is received on the Odero POS terminal.
  5. Client app terminates the socket connection.
  6. Client app receives onDisconnected callback.
  7. Odero POS terminal switchs from wifi to gsm data as required by the bank app in order to perform the transaction on secure connection. Also the host socket server is shut down.
  8. Odero POS terminal host awaits for response from the bank app.
  9. Client app sends connnection ping requests attempting to connect to the socket server on the host device. These attempts fail at this point because the socket server is shut down as described in previous step.
  10. Host app receives response from the bank app, network switch from gsm to wifi occurs and the socket server is started.
  11. Client app connection request is successful.
  12. Host app on Odero POS terminal sends the response from the bank app and is received on the client app (windows)

The client app side implementation is rather simple, only step 4 is required to be perfomed, all other steps on the client side are performed under the hood inside the library.

Setup

  1. Download the latest OPIT Lan for Windows release and unzip the archive.
  2. Copy archive contents inside the sample project folder.
  3. Open the sample app project solution with Microsoft Visual Studio (make sure C++ module is installed).
  4. In Microsoft Visual Studio go to Project -> Properties -> C/C++ -> Command Line -> Additional Options -> add text: /std:c++latest

  5. C/C++ -> General -> Additional Include Directories -> click on the dropdown -> Edit -> in the popup press the 3 dots (...) button from the right -> Choose headers folder from the opit-desktop project -> Ok

  6. Linker -> Input -> Additional Dependencies -> click on the dropdown -> Edit -> add text: OpitDesktop.lib -> Ok

  7. Linker -> General -> Additional Library Directories -> click on the dropdown -> Edit -> in the popup press the 3 dots (...) button from the right -> select the folder where the OpitDesktop.lib file is located -> Ok

  8. That's it! The solution should now build.