COM extension for Windows integration

This document applies for library version 1.8. For the previous version (1.6), click here.

Use the COM (Common object model) extension for Windows to integrate your POS solution with the Adyen platform. This extension uses the COM to enable communication between your POS solution, written in a language that supports COM, and the PED firmware.

Architecture

The COM extension for Windows implements a process of callback registration that defines coupling with the POS application. This allows for platform-independent, loosely coupled, implementation. Use the documentation to enforce proper code conventions, implement required elements, and ensure technical accuracy. This helps to avoid exceptions and simplifies error detection. 

The COM extension for Windows is a server object, not a DLL. For VB you can use tlbimp to generate a DLL that can be linked to your cash register application.

The callback handlers are functions that require their own identifier. This should include a substring indicating the type of callback along with the naming convention.

Adyen provides the COM extension for Windows as a single service executable, containing payment and registration functionality through the underlying C LIbrary. Register the COM extension for Windows as a service in the registry of the cash register. Registration and de-registration example batch files are provided.  

The Adyen POS solution

The Adyen POS solution consists of a PIN Entry Device (PED) (running Adyen's payment software), a library (integrated in the Cash Register environment) and Adyen's payment system. Your POS connects to the PED via a serial, Ethernet or Wi-Fi connection.

To perform online transactions, you must connect both the POS system and the PED to the Internet. The PED can connect to the Adyen platform directly or by using the POS system as a proxy, which requires a physical connection between the PED and POS. 

You must authorise your POS system to connect to the Adyen systems, at least during the deployment and boarding of new PEDs. The POS system uses our C library functions to register associated PEDs. This allows you to exchange PEDs quickly and easily, and does not require you to store credentials on the device. This also means you don't need to contact Adyen to swap terminals, for example, in case of a replacement.

Multiple PEDs may be connected to a single POS system. The cash register application provides the staff with an interface to switch dynamically between these connected PEDs when required.

Questions

Can't find something you are looking for? Look at our FAQ for answers or send an email to support.