Dynamics 365 Payment Connector for Adyen overview

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.

Key terms

Term Description
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).
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.
Card not present Refers to payment transactions where a physical card isn't 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.

Supported features, functionality, versions, and terminals

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

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.

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 point of sale (POS). The same values below also represent the Commerce and Adyen firmware versions supported for Dynamics 365 Commerce Store Commerce.


Dynamics 365 Retail POS version 10.0.36

Minimum Adyen Firmware version Maximum Adyen Firmware version
adyen_v1_91p2 adyen_v1_91p15

Note

  • 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.

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.

The following video describes the capabilities of the Adyen Castles SE1 Android payment terminal.

Supported payment instruments

Supported debit and credit cards

Brand Variant Card present e-Commerce Call Center
MasterCard Credit ✔ ✔ ✔
MasterCard Debit ✔ ✔ ✔
MasterCard Alpha Bank Bonus ✔ ✔ ✔
MasterCard Apple Pay ✔
MasterCard Samsung Pay ✔
MasterCard Maestro ✔ ✔ ✔
MasterCard Maestro Samsung Pay ✔
MasterCard Maestro UK ✔ ✔ ✔
VISA Credit ✔ ✔ ✔
VISA Debit ✔ ✔ ✔
VISA Alpha Bank Bonus ✔ ✔ ✔
VISA Android Pay ✔
VISA Apple Pay ✔
VISA Samsung Pay ✔
VISA VISA Checkout ✔ ✔ ✔
VISA VISA Dankort ✔ ✔ ✔
VISA VISA Hipotecario ✔ ✔ ✔
VISA VISA Aravia Card ✔ ✔ ✔
AMEX Credit ✔ ✔ ✔
AMEX Debit ✔ ✔ ✔
AMEX Android Pay ✔
AMEX Apple Pay ✔
AMEX Samsung Pay ✔
AMEX AMEX Commercial ✔ ✔ ✔
AMEX AMEX Consumer ✔ ✔ ✔
AMEX AMEX Corporate ✔ ✔ ✔
AMEX AMEX Small Business ✔ ✔ ✔
Discover Standard ✔ ✔ ✔
Discover Android Pay ✔
Discover Apple Pay ✔
Discover Samsung Pay ✔
Diners Standard ✔ ✔ ✔
Dineromail Standard ✔ ✔ ✔
Japan Credit Bureau (JCB) Standard ✔ ✔ ✔
Union Pay* Standard ✔
Interac Debit* Standard ✔

*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 ✔ ✔
Stored Value Solutions (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.

Digital wallet support status

The following table lists the current Dynamics 365 Commerce Payment Connector for Adyen support status of popular digital wallets. The "Card present support" column is for POS transactions, and the "Card not present support" column is for call center and online channel transactions.

Scheme Card present support Card not present support
PayPal (via Adyen Connector) No No
Google Pay ✔ ✔
Apple Pay ✔ ✔
Afterpay No No
Klarna No No
Affirm ✔ No
Alipay ✔ No
WeChat Pay ✔ No

Note

Support for Affirm, Alipay, and WeChatPay payment methods is added for "card present" scenarios starting with Commerce version 10.0.40. For inormation on setup and known limitations, see Wallet payment support.

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/regions

The following countries/regions have Commerce components available and card present support from Adyen. For current international availability of Commerce, visit the International availability page.

Country/region Supported
Australia ✔
Austria ✔
Belgium ✔
Canada ✔
Czech Republic ✔
Denmark ✔
Estonia ✔
Finland ✔
France ✔
Germany ✔
Hong Kong SAR ✔
Hungary ✔
Iceland ✔
Ireland ✔
Italy ✔
Japan ✔
Latvia ✔
Lithuania ✔
Malaysia ✔
Mexico ✔
Netherlands ✔
New Zealand ✔
Norway ✔
Poland ✔
Singapore ✔
Switzerland ✔
Spain ✔
Sweden ✔
Switzerland ✔
United Arab Emirates (UAE) ✔
United Kingdom ✔
United States ✔
Brazil ✔

Supported card not present countries/regions

Adyen supports the following countries/regions for card not present transactions. For details about support for a specific country/region, contact Adyen. For information on the current international availability of Commerce, see International availability page.

Country/region
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
Türkiye
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.

Scheme Card present Card not present
Cash Out Gift Card Balance ✔
Duplicate Payment Protection ✔
Omni Channel Tokenization ✔ ✔
Linked Refunds ✔
(Starting with 10.0.1)
✔
(Starting with 10.0.1)
Save online payments ✔
(Starting with 10.0.2)
External gift cards for call center and e-commerce ✔
(Starting with 10.0.10)
SCA payment redirect ✔
(Starting with 10.0.12)
Dedicated payment terminals and prompts for a printer and cash drawer ✔
(Starting with 10.0.12)
SDK-level tipping support through the Adyen connector ✔
(Starting with 10.0.14)
Incremental capture for order invoicing ✔
(Starting with 10.0.18)
Wallet Payments ✔
(Starting with 10.0.20)
Google Pay with Adyen ✔
(Starting with 10.0.27)

Next steps

For information on signing up for and configuring the Dynamics 365 Payment Connector for Adyen, see Dynamics 365 Payment Connector for Adyen setup.

Additional resources

Set up Dynamics 365 Payment Connector for Adyen

Dynamics 365 Payment Connector for Adyen FAQ

Troubleshoot Dynamics 365 Payment Connector for Adyen

Payments FAQ