{"title":"COM extension for Windows integration","category":"default","creationDate":1776961627,"content":"<div class=\"sc-notice warning\"><div>\n<p>We are <a href=\"\/pt\/point-of-sale\/classic-library-deprecation\">discontinuing classic libraries<\/a>. If you are currently using a classic library, you need to migrate to <a href=\"\/pt\/point-of-sale\/design-your-integration\/terminal-api\">Terminal API<\/a>.<br \/>\nDo not build a new integration with a classic library.<\/p>\n<\/div><\/div>\n<p>Use the COM (Common Object Model) extension for Windows\u00a0to integrate your POS solution with the plataforma de pagamentos da Adyen. This extension uses the COM to enable communication between your POS solution, written in a language that supports COM, and the PED firmware.<\/p>\n<h2 id=\"architecture\">Architecture<\/h2>\n<p><img alt=\"\" src=\"\/user\/pages\/reuse\/pos-reuse\/12.architecturediagram\/noText_pos-architecture.png\" \/><\/p>\n<p>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.\u00a0<\/p>\n<div class=\"sc-notice note\"><div>\n<p>The COM extension for Windows is a server object, not a DLL. For VB you can use <code>tlbimp<\/code> to generate a DLL that can be linked to your cash register application.<\/p>\n<\/div><\/div>\n<p>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.<\/p>\n<p>Adyen provides the COM extension for Windows as a single service executable, containing payment and registration functionality\u00a0through\u00a0the underlying C Library. Register the COM extension for Windows as a service in the registry of the cash register. Registration and\u00a0de-registration\u00a0example batch files are provided. \u00a0<\/p>\n<h2 id=\"the-adyen-pos-solution\">The Adyen POS solution<\/h2>\n<p>The Adyen POS solution consists of:<\/p>\n<ul>\n<li>A PIN Entry Device (PED) (running Adyen's payment software)<\/li>\n<li>A library (integrated in the cash register environment)<\/li>\n<li>The\u00a0plataforma de pagamentos da Adyen.<\/li>\n<\/ul>\n<p>Your POS connects to the PED via a serial, Ethernet, Wi-Fi, Bluetooth or USB connection.<\/p>\n<p>To perform online transactions, you must connect both the POS system and the PED to the Internet. The PED can connect to the\u00a0plataforma de pagamentos da Adyen\u00a0directly, or by using the POS system as a proxy, which requires a physical connection between the PED and POS.\u00a0<\/p>\n<p>You must authorize your POS system to connect to the plataforma de pagamentos da Adyen, at least during the deployment and boarding of new PEDs. The POS 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 do not need to contact Adyen to swap terminals. for example, in case of a replacement.<\/p>\n<p>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.<\/p>","url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/com-extension-for-windows-integration","articleFields":{"id":"25143488","type":"page","_expandable":{"operations":""},"status":"current"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/com-extension-for-windows-integration","title":"COM extension for Windows integration","content":"\nWe are discontinuing classic libraries. If you are currently using a classic library, you need to migrate to Terminal API.\nDo not build a new integration with a classic library.\n\nUse the COM (Common Object Model) extension for Windows\u00a0to integrate your POS solution with the plataforma de pagamentos da Adyen. This extension uses the COM to enable communication between your POS solution, written in a language that supports COM, and the PED firmware.\nArchitecture\n\nThe 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.\u00a0\n\nThe 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.\n\nThe callback handlers are functions that require their own identifier. This should include a substring indicating the type of callback along with the naming convention.\nAdyen provides the COM extension for Windows as a single service executable, containing payment and registration functionality\u00a0through\u00a0the underlying C Library. Register the COM extension for Windows as a service in the registry of the cash register. Registration and\u00a0de-registration\u00a0example batch files are provided. \u00a0\nThe Adyen POS solution\nThe Adyen POS solution consists of:\n\nA PIN Entry Device (PED) (running Adyen's payment software)\nA library (integrated in the cash register environment)\nThe\u00a0plataforma de pagamentos da Adyen.\n\nYour POS connects to the PED via a serial, Ethernet, Wi-Fi, Bluetooth or USB connection.\nTo perform online transactions, you must connect both the POS system and the PED to the Internet. The PED can connect to the\u00a0plataforma de pagamentos da Adyen\u00a0directly, or by using the POS system as a proxy, which requires a physical connection between the PED and POS.\u00a0\nYou must authorize your POS system to connect to the plataforma de pagamentos da Adyen, at least during the deployment and boarding of new PEDs. The POS 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 do not need to contact Adyen to swap terminals. for example, in case of a replacement.\nMultiple 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.","type":"page","locale":"pt","boost":16,"hierarchy":{"lvl0":"Home","lvl1":"Terminais","lvl2":"Deprecation of classic libraries","lvl3":"Library integrations","lvl4":"COM extension for Windows integration"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/point-of-sale","lvl2":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/classic-library-deprecation","lvl3":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/classic-library-deprecation\/classic-library-integrations","lvl4":"\/pt\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/com-extension-for-windows-integration"},"levels":5,"category":"In-person payments","category_color":"green","tags":["extension","Windows","integration"]}}
