title: Dynamics 365 Payment Connector for Adyen overview
description: This article provides an overview of the Microsoft Dynamics 365 Payment Connector for Adyen.
author: Reza-Assadi
ms.date: 05/06/2022
This article provides an overview of the Microsoft Dynamics 365 Payment Connector for Adyen and includes a comprehensive list of supported features and functionality. Related articles cover Adyen sign up, configuration of the connector, frequently asked questions, and troubleshooting guidance for some common issues.
ms.topic: overview
ms.prod:
Key terms
ms.technology:
audience: IT Pro
| Term | Description |
ms.reviewer: josaw
|---|---|
ms.search.region: Global
| Payment connector | An extension that facilitates communication between Microsoft Dynamics 365 Commerce (and associated components) and a payment service. The connector that is described in this article was implemented by using the standard payments software development kit (SDK). |
ms.author: rassadi
| Card present | Refers to payment transactions where a physical card is presented and used on a payment terminal connector to the Dynamics 365 Point of Sale. |
ms.search.validFrom: 2019-01-01
| Card not present | Refers to payment transactions where a physical card is not present, such as e-Commerce or Call Center scenarios. In these scenarios, the payment-related information is entered manually either on an e-Commerce website, a Call Center flow, or on the point-of-sale or payment terminal. |
ms.dyn365.ops.version: AX 7.0.1
ms.custom: 141393
Supported features, functionality, versions, and terminals
ms.assetid: e23e944c-15de-459d-bcc5-ea03615ebf4c
ms.search.industry: Retail
The out-of-box Dynamics 365 Payment Connector for Adyen uses the standard payments SDK. Therefore, it doesn't have special capabilities that aren't also available to other payment connectors.
Supported versions
Note
Microsoft Dynamics 365 supported versions
Adyen may release minor version updates after Microsoft has tested the major version. As long as a major version is supported, it's okay to have minor version updates within the same major version. These updates are normally very targeted fixes and don't meet the bar for full retesting, as long as the same major firmware version was previously tested. Updates shouldn't exceed the maximum Adyen firmware version listed in documentation.
The first-party out-of-box Dynamics 365 Payment Connector for Adyen is supported in Microsoft Dynamics 365 Finance version 8.1.3 (January 2019) or later, and in Microsoft Dynamics 365 Retail version 8.1.3 or later. However, third parties can still develop other payment connectors for Adyen for earlier versions of Microsoft Dynamics 365.
Migrating from a Adyen firmware version earlier than version 53 to version 53 requires POS KB 4577957 for monthly updates of Commerce, versions 10.0.11 through 10.0.14. If one of those versions is in use and doesn't include the hotfix, post-upgrade of the payment terminal will only allow payments via NFC. Applying the hotfix to the POS resolves this issue. If the POS version is older than version 10.0.11, file a support request noting that a fix for KB 4577957 is required for an out of service MPOS.
Supported Adyen Firmware versions
The list below describes the minimum and maximum Adyen firmware versions that are supported for each version of the Microsoft Dynamics 365 Retail POS.
For Adyen firmware versions 59p7 through 62p9, the gift card cash out operation requests PIN entry twice in scenarios where the gift card is manually entered. This issue is not reproduced when the gift card is swiped. Adyen is investigating.
Supported payment terminals
The Dynamics 365 Payment Connector for Adyen takes advantage of the device-agnostic Adyen Payment Terminal API. It supports all payment terminals that this application programming interface (API) supports. For a complete list of supported payment terminals, visit the Adyen POS terminals page.
*Interac and Union Pay recurring card tokens aren't provided by Adyen, so they can't be supported for card not present transactions.
Supported gift cards
Scheme
Card present
Card not present
Givex
✔
✔
SVS
✔
✔
To support these external gift card schemes through the Dynamics 365 Payment Connector for Adyen, you must complete additional steps. For more information, see Support for external gift cards.
Supported wallets
Scheme
Card present
Card not present
Alipay
Support will be added in a future release.
No
WeChat
Support will be added in a future release.
No
Supported card present input methods
Input method
Supported
Notes
Dip
✔
Swipe
✔
Tap
✔
Manual Entry through POS UI.
Not supported at this time
Manual Entry through Payment Terminal.
✔
Supports manual entry of credit, debit, and gift cards with pin entry.
Supported card present countries
The following countries have Commerce components available and card present support from Adyen. For current international availability of Commerce, visit the International availability page.
Country
Supported
Australia
✔
Austria
✔
Belgium
✔
Canada
✔
Czech Republic
✔
Denmark
✔
Estonia
✔
Finland
✔
France
✔
Germany
✔
Hong Kong SAR
✔
Hungary
✔
Iceland
✔
Ireland
✔
Italy
✔
Japan
Future release
Latvia
✔
Lithuania
✔
Malaysia
✔
Netherlands
✔
New Zealand
✔
Norway
✔
Poland
✔
Singapore
✔
Switzerland
✔
Spain
✔
Sweden
✔
Switzerland
✔
United Kingdom
✔
United States
✔
Brazil
Future release
Supported card not present countries
The following countries are supported by Adyen for card not present transactions. Contact Adyen for details about support for a specific country. For current international availability of Commerce, visit the International availability page.
Country
Argentina
Armenia
Australia
Austria
Bahrain
Belgium
Brazil
Bulgaria
Canada
Chile
China
Colombia
Croatia
Cyprus
Czech Republic
Denmark
Egypt
Estonia
Finland
France
Georgia
Germany
Gibraltar
Greece
Guernsey
Hong Kong SAR
Hungary
Iceland
India
Indonesia
Ireland
Isle of Man
Israel
Italy
Japan
Jersey
Korea
Kuwait
Latvia
Lithuania
Luxembourg
Malaysia
Malta
Mexico
Morocco
Netherlands
New Zealand
Norway
Peru
Poland
Portugal
Qatar
Romania
Saudi Arabia
Serbia
Singapore
Slovakia
Slovenia
South Africa
Spain
Sweden
Switzerland
Taiwan
Tanzania
Thailand
Turkey
United Arab Emirates (UAE)
United Kingdom
United States of America including Puerto Rico
Supported Dynamics 365 payment features
The following table shows the set of features that the Dynamics 365 Payment Connector for Adyen supports. These features use enhancements that were introduced in the payments SDK and some components in December 2018. They aren't exclusive to the Dynamics 365 Payment Connector for Adyen. For more information about how to uptake these enhancements for a different payment connector, see Create an end-to-end payment integration for a payment terminal.