Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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 described in this article uses 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 Commerce or Call Center scenarios. In these scenarios, the payment-related information is entered manually either on a 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
Microsoft supports the first-party out-of-the-box Dynamics 365 Payment Connector for Adyen 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 following list 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 also represent the Commerce and Adyen firmware versions supported for Dynamics 365 Commerce Store Commerce.
Dynamics 365 Commerce POS version 10.0.44
| Minimum Adyen Firmware version | Maximum Adyen Firmware version |
|---|---|
| adyen_v1_114 | adyen_v1_117 |
Note
Adyen might release minor version updates after Microsoft tests the major version. As long as a major version is supported, it's acceptable to have minor version updates within the same major version. These updates normally target 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 the documentation.
Supported payment terminals
The Dynamics 365 Payment Connector for Adyen uses the device-agnostic Adyen Terminal API. It supports all payment terminals that this application programming interface (API) supports. For a complete list of Adyen payment terminals, see Adyen POS terminals.
Note
Use payment card industry (PCI) approved payment terminals that are PIN Transaction Security Point of Interaction (PTS POI) devices. For a list of approved devices for Adyen, see PCI PTS POI devices.
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 | 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 | ✔ |
*Adyen doesn't provide recurring card tokens for Interac and UnionPay, so they can't support 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 more 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 |
| Affirm | ✔ | No |
| Alipay | ✔ | No |
| WeChat Pay | ✔ | No |
Note
In Commerce releases before version 10.0.45, to enable using digital wallets to place orders via POS and return those orders in call center, you must contact Microsoft to enable the RetailPaymentCreateNonRecurringCreditCardFlight flight. For information on setup and the known limitations for digital wallets, see Wallet payment support.
Supported card present input methods
| Input method | Supported | Notes |
|---|---|---|
| Dip | ✔ | |
| Swipe | ✔ | |
| Tap | ✔ | |
| Manual Entry through POS UI. | Not supported for Adyen connector | |
| 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 or regions have Commerce components available and card present support from Adyen. For current international availability of Commerce, visit the International availability page.
| Country or 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 or regions
Adyen supports the following countries or regions for card-not-present transactions. For details about support for a specific country or region, contact Adyen. For information on the current international availability of Commerce, see International availability page.
| Country or 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 | ✔ | ✔ |
| Save online payments | ✔ | |
| External gift cards for call center and e-commerce | ✔ | |
| SCA payment redirect | ✔ | |
| Dedicated payment terminals and prompts for a printer and cash drawer | ✔ | |
| SDK-level tipping support through the Adyen connector | ✔ | |
| Incremental capture for order invoicing | ✔ | |
| Wallet Payments | ✔ | |
| Google Pay with Adyen | ✔ | |
| Adyen risk management for online payments | ✔(Starting with 10.0.43) |
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.