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