Dynamics 365 Payment Connector for Adyen overview

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


Key terms


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


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.

Dynamics 365 Retail POS version 10.0.23

Supported payment instruments

| Minimum Adyen Firmware version | Maximum Adyen Firmware version |

| --- | --- |

Supported debit and credit cards

| adyen_v1_69p5 | adyen_v1_71p16 |

| Brand | Variant | Card present | e-Commerce | Call Center |