{"title":"Release notes - Library V1.14","category":"default","creationDate":1792753037,"content":"<p>We're pleased to announce a new family of libraries and support features to integrate with our payment terminals. The libraries, COM for Windows, Java Native Interface and C, are built on the same core application. This allows merchants operating on Windows, Linux, or OSX based POS systems to integrate with Adyen's payment terminals. The updated libraries also work with all Adyen's mobile and countertop PIN entry devices.\u00a0<\/p>\n<h2 id=\"new-functionality\">New functionality<\/h2>\n<h3 id=\"cashback-and-cashout-for-eftpos\">Cashback and cashout for EFTPOS<\/h3>\n<p>Cashback and cashout are now supported for EFTPOS transactions.\u00a0<\/p>\n<ul>\n<li>Initiate a cashback transaction with the transaction type\u00a0<code>GOODS_SERVICES_WITH_CASHBACK<\/code>. Include the amount of the cashback in the\u00a0<code>cashbackAmount<\/code>\u00a0field of the additional data object.<\/li>\n<li>Initiate a cashout transaction with the transaction type\u00a0<code>CASHOUT<\/code>.<\/li>\n<\/ul>\n<p>New error codes \"Cashback not supported\" and \"Cashout not supported\" have also been introduced.<\/p>\n<div class=\"sc-notice note\"><div>\n<p>Cashback and cashout transactions are supported by EVO terminals with firmware v1.30 or later. Support for VOS terminals and other schemes will be added in the near future.<\/p>\n<\/div><\/div>\n<h3 id=\"skip-aid-priority\">Skip AID priority<\/h3>\n<p>You can now use the tender option\u00a0<code>SkipAIDPriority<\/code>\u00a0to skip a card's application identifier (AID) priority.\u00a0This allows a shopper to select their preferred card application.<\/p>\n<h2 id=\"improved-functionality\">Improved functionality<\/h2>\n<h3 id=\"partial-refund-retries\">Partial refund retries<\/h3>\n<p>For a variety of reasons, a partial refund may fail, for example if the amount has not been captured, or the merchant account doesn't have funds. In this instance, partial refunds now will be rescheduled and retried. In a case of delayed capture, the partial refund will be rescheduled and retried after the capture.<\/p>\n<p>You can find the documentation for partial refunds here:\u00a0<\/p>\n<ul>\n<li><a href=\"\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/com-extension-for-windows-integration\/key-steps-com-extension\/cancel-or-refund-a-transaction-com-extension\/partially-refund-a-balance-com\">COM Partial Refund<\/a><\/li>\n<li><a href=\"\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/java-native-interface-integration\/key-steps-jni\/cancel-or-refund-a-transaction-jni\/partially-refund-a-balance-jni\">JNI Partial Refund<\/a><\/li>\n<li><a href=\"\/point-of-sale\/classic-library-deprecation\/classic-library-integrations\/c-library-integration\/key-steps-c-library\/cancel-or-refund-a-transaction-c-library\/partially-refund-a-balance-c-library\">C Partial Refund<\/a><\/li>\n<\/ul>\n<h3 id=\"final-state-unknown\">Final state UNKNOWN<\/h3>\n<p>When there is a communication issue between the POS terminal and the <strong>library<\/strong>, the final state will now be reported as <code>UNKNOWN<\/code>\u00a0in the library.\u00a0<\/p>\n<h2 id=\"fixed-issues\">Fixed issues<\/h2>\n<ul>\n<li>Fixed an issue that could cause the library token to be lost when there was a communication failure.<\/li>\n<\/ul>","url":"https:\/\/docs.adyen.com\/point-of-sale\/posmerchantcontent\/library-release-notes\/release-notes-library-v1-14","articleFields":{"id":"36192247","robots":"noindex,nofollow","type":"page","_expandable":{"operations":""},"status":"current"},"algolia":{"url":"https:\/\/docs.adyen.com\/point-of-sale\/posmerchantcontent\/library-release-notes\/release-notes-library-v1-14","title":"Release notes - Library V1.14","content":"We're pleased to announce a new family of libraries and support features to integrate with our payment terminals. The libraries, COM for Windows, Java Native Interface and C, are built on the same core application. This allows merchants operating on Windows, Linux, or OSX based POS systems to integrate with Adyen's payment terminals. The updated libraries also work with all Adyen's mobile and countertop PIN entry devices.\u00a0\nNew functionality\nCashback and cashout for EFTPOS\nCashback and cashout are now supported for EFTPOS transactions.\u00a0\n\nInitiate a cashback transaction with the transaction type\u00a0GOODS_SERVICES_WITH_CASHBACK. Include the amount of the cashback in the\u00a0cashbackAmount\u00a0field of the additional data object.\nInitiate a cashout transaction with the transaction type\u00a0CASHOUT.\n\nNew error codes \"Cashback not supported\" and \"Cashout not supported\" have also been introduced.\n\nCashback and cashout transactions are supported by EVO terminals with firmware v1.30 or later. Support for VOS terminals and other schemes will be added in the near future.\n\nSkip AID priority\nYou can now use the tender option\u00a0SkipAIDPriority\u00a0to skip a card's application identifier (AID) priority.\u00a0This allows a shopper to select their preferred card application.\nImproved functionality\nPartial refund retries\nFor a variety of reasons, a partial refund may fail, for example if the amount has not been captured, or the merchant account doesn't have funds. In this instance, partial refunds now will be rescheduled and retried. In a case of delayed capture, the partial refund will be rescheduled and retried after the capture.\nYou can find the documentation for partial refunds here:\u00a0\n\nCOM Partial Refund\nJNI Partial Refund\nC Partial Refund\n\nFinal state UNKNOWN\nWhen there is a communication issue between the POS terminal and the library, the final state will now be reported as UNKNOWN\u00a0in the library.\u00a0\nFixed issues\n\nFixed an issue that could cause the library token to be lost when there was a communication failure.\n","type":"page","locale":"en","boost":16,"hierarchy":{"lvl0":"Home","lvl1":"In-person payments","lvl2":"POSMerchantContent","lvl3":"Library release notes","lvl4":"Release notes - Library V1.14"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/","lvl1":"https:\/\/docs.adyen.com\/point-of-sale","lvl2":"https:\/\/docs.adyen.com\/point-of-sale\/posmerchantcontent","lvl3":"https:\/\/docs.adyen.com\/point-of-sale\/posmerchantcontent\/library-release-notes","lvl4":"\/point-of-sale\/posmerchantcontent\/library-release-notes\/release-notes-library-v1-14"},"levels":5,"category":"In-person payments","category_color":"green","tags":["Release","notes","Library","V1.14"]}}
