{"title":"C library integration","category":"default","creationDate":1776961627,"content":"
\n

We are discontinuing classic libraries<\/a>. If you are currently using a classic library, you need to migrate to Terminal API<\/a>.
\nDo not build a new integration with a classic library.<\/p>\n<\/div><\/div>\n

Use the C Library\u00a0to allow communication between a POS application, terminal, and the plataforma de pagamentos da Adyen. Register the POS app and terminal, create transactions, and review\u00a0library responses to check status of request.<\/p>\n

C library transaction flow<\/h2>\n

The transaction flow is:<\/p>\n

    \n
  1. Initialize the library (init_task<\/code>) - Do this before starting the first transaction, but not for subsequent transactions.<\/li>\n
  2. Register the POS (register_app<\/code>)<\/li>\n
  3. Register PIN Entry Devices (PEDs) (register_device<\/code>)<\/li>\n
  4. Start a transaction (create_tender<\/code>) - \u00a0this step can be repeated as many times as required<\/li>\n
  5. Exit the library (exit_task<\/code>)<\/li>\n<\/ol>\n

    Architecture<\/h2>\n

    \"\"<\/p>\n

    The Adyen POS solution<\/h2>\n

    The Adyen POS solution consists of:<\/p>\n

      \n
    • A PIN Entry Device (PED) (running Adyen's payment software)<\/li>\n
    • A library (integrated in the cash register environment)<\/li>\n
    • The\u00a0plataforma de pagamentos da Adyen.<\/li>\n<\/ul>\n

      Your POS connects to the PED via a serial, Ethernet, Wi-Fi, Bluetooth or USB connection.<\/p>\n

      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

      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

      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>\n

      Library feedback<\/h2>\n

      The library represents results, states\u00a0and other fixed values using enums. The\u00a0adyen_enum.h<\/strong><\/span>\u00a0file contains these enums. Helper functions are available to convert strings to enums and enums to strings.<\/p>\n

      Include\u00a0POSLibC.h<\/strong><\/span>\u00a0as this will handle your platform specifics, such as threading, data models, platform specifications and so on.<\/p>\n

      \n

      The POS App should use the enumerated values instead of the underlying values. For example, if a value of an enum should be stored to disk, store the string and not the integer value.<\/p>\n<\/div><\/div>","url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/c-library-integration","articleFields":{"id":"24217490","type":"page","_expandable":{"operations":""},"status":"current"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/c-library-integration","title":"C library 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 C Library\u00a0to allow communication between a POS application, terminal, and the plataforma de pagamentos da Adyen. Register the POS app and terminal, create transactions, and review\u00a0library responses to check status of request.\nC library transaction flow\nThe transaction flow is:\n\nInitialize the library (init_task) - Do this before starting the first transaction, but not for subsequent transactions.\nRegister the POS (register_app)\nRegister PIN Entry Devices (PEDs) (register_device)\nStart a transaction (create_tender) - \u00a0this step can be repeated as many times as required\nExit the library (exit_task)\n\nArchitecture\n\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.\nLibrary feedback\nThe library represents results, states\u00a0and other fixed values using enums. The\u00a0adyen_enum.h\u00a0file contains these enums. Helper functions are available to convert strings to enums and enums to strings.\nInclude\u00a0POSLibC.h\u00a0as this will handle your platform specifics, such as threading, data models, platform specifications and so on.\n\nThe POS App should use the enumerated values instead of the underlying values. For example, if a value of an enum should be stored to disk, store the string and not the integer value.\n","type":"page","locale":"pt","boost":16,"hierarchy":{"lvl0":"Home","lvl1":"Terminais","lvl2":"Deprecation of classic libraries","lvl3":"Library integrations","lvl4":"C library 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\/c-library-integration"},"levels":5,"category":"In-person payments","category_color":"green","tags":["library","integration"]}}