{"title":"Microsoft Dynamics 365","category":"default","creationDate":1674048060,"content":"<div class=\"additional-info-block output-inline\">\n<div class=\"additional-info-block__body\"><p><img style=\"width: 38px;\" alt=\"\" src=\"\/user\/pages\/docs\/05.plugins\/26.microsoft-dynamics\/dynamics_logo.svg?decoding=auto&amp;fetchpriority=auto\" \/>&nbsp; <strong>Read more<\/strong><\/p><p>Learn more about <a href=\"https:\/\/www.adyen.com\/partners\/dynamics-365-commerce\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Microsoft Dynamics 365<\/a> in our Partner Directory.<\/p><\/div><\/div>\n\n<p>When you use Microsoft Dynamics 365 Commerce as your omnichannel solution, the <strong>Dynamics 365 Payment Connector for Adyen<\/strong> allows you to process payments across your sales channels through the plataforma de pagamentos da Adyen. With the Adyen payment connector you can accept:<\/p>\n<ul>\n<li>All major global credit and debit cards, both online and in-store.<\/li>\n<li>Point-of-sale transactions with Givex and SVS gift cards.<\/li>\n<li>Point-of-sale transactions with Android Pay, Apple Pay, and Samsung Pay wallets.<\/li>\n<\/ul>\n<p>You can use the Adyen payment connector with all Dynamics 365 Commerce channels:<\/p>\n<ul>\n<li><strong>Modern POS (MPOS)<\/strong> - Interfaces with the Adyen Terminal API using local communications. It allows you to continue processing payments when offline, and to access payment terminals, printers, and cash drawers directly.<\/li>\n<li><strong>Cloud POS (CPOS)<\/strong> - Interfaces with the Adyen Terminal API using cloud communications. It runs in a browser and therefore cannot work offline and can only access the payment terminals, printers, and cash drawers through a hardware station.<\/li>\n<li><strong>e-Commerce<\/strong> - Interfaces with the Adyen Checkout API.<\/li>\n<li><strong>Call Center<\/strong> - Interfaces with the Adyen Checkout API.<\/li>\n<\/ul>\n<h2 id=\"before-you-begin\">Requirements<\/h2>\n<p>Before you begin to integrate, make sure you have followed the <a href=\"\/pt\/get-started-with-adyen\">Get started with Adyen guide<\/a> to:<\/p>\n<ul>\n<li>Get an overview of the steps needed to accept live payments.<\/li>\n<li>Create your test account.<\/li>\n<\/ul>\n<p>If you use more than one sales channel, for example MPOS and e-Commerce, <a href=\"\/pt\/account\/manage-account-structure#request-merchant-account\">request additional merchant accounts<\/a>. You need to have a separate merchant account for each channel.<\/p>\n<p>While you wait for your application for a live account to be approved, you can:<\/p>\n<ol>\n<li><a href=\"#adyen-configuration\">Configure your Adyen account<\/a>.<\/li>\n<li><a href=\"#get-adyen-terminals\">Order Adyen payment terminals<\/a> for your MPOS or CPOS retail channel (if applicable).<\/li>\n<li><a href=\"#set-up-dynamics\">Set up the Adyen payment connector in Dynamics 365<\/a>.<\/li>\n<\/ol>\n<h2 id=\"adyen-configuration\">Step 1: Configure your Adyen account<\/h2>\n<p>Our Support Team will take care of part of your account configuration. But there are a few steps that you need to do yourself. The most important step is to create separate API credentials for each of your sales channels.<\/p>\n<p>Select the following tabs to see what you need to do for MPOS, CPOS, e-Commerce, or Call Center.<\/p>\n\n<div id=\"tabkZWtu\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;MPOS&quot;,&quot;content&quot;:&quot;\\n&lt;ol&gt;\\n&lt;li&gt;\\n&lt;p&gt;Log in to your &lt;a href=\\&quot;https:\\\/\\\/ca-test.adyen.com\\\/\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;Customer Area&lt;\\\/a&gt; and make sure you are on the company account level (in the top-right corner, under the name of your company account, &lt;em&gt;no merchant selected&lt;\\\/em&gt; is shown).&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Create a new API credential for MPOS:&lt;\\\/p&gt;\\n&lt;div class=\\&quot;notices yellow\\&quot;&gt;\\n&lt;p&gt;Do not use or configure the default API credential &lt;strong&gt;ws@Company.[YourCompanyAccount]&lt;\\\/strong&gt; that was created when you signed up with Adyen.&lt;\\\/p&gt;\\n&lt;\\\/div&gt;\\n&lt;ol&gt;\\n&lt;li&gt;\\n&lt;p&gt;Go to &lt;strong&gt;Developers&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;API credentials&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select &lt;strong&gt;Create new credential&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Under &lt;strong&gt;Credential type&lt;\\\/strong&gt;, select &lt;strong&gt;Web service&lt;\\\/strong&gt;. You can add a description here.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Make a note of the API credential name.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select &lt;strong&gt;Create credential&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Under &lt;strong&gt;Server settings&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Authentication&lt;\\\/strong&gt;, elect the &lt;strong&gt;API key&lt;\\\/strong&gt; tab.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select &lt;strong&gt;Generate API key&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Copy the API key using the copy icon &lt;i class=\\&quot;adl-icon-copy\\&quot;&gt;&lt;\\\/i&gt; and store your API key securely in your system.&lt;br \\\/&gt;\\nYou will need to add this API key in the Dynamics 365 configuration for MPOS.&lt;\\\/p&gt;\\n&lt;div class=\\&quot;notices yellow\\&quot;&gt;\\n&lt;p&gt;If you lose this API key you won&#039;t be able to restore it later.&lt;\\\/p&gt;\\n&lt;\\\/div&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Under &lt;strong&gt;Roles and Associated Accounts&lt;\\\/strong&gt;, enable the following roles:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;Merchant Recurring Role&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;p&gt;Our Support Team will enable more roles for you:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;POS initial Configuration&lt;\\\/li&gt;\\n&lt;li&gt;Terminal Registration Role&lt;\\\/li&gt;\\n&lt;li&gt;Terminal Management API Role&lt;\\\/li&gt;\\n&lt;li&gt;Device with Payload Encryption Role&lt;\\\/li&gt;\\n&lt;li&gt;Allow firmware download for POS devices\\n&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select &lt;strong&gt;Save changes&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Configure response settings:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;Switch to the merchant account you created for MPOS.&lt;\\\/li&gt;\\n&lt;li&gt;Go to &lt;strong&gt;Developers&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Additional data&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Select the &lt;strong&gt;Toggle all fields&lt;\\\/strong&gt; checkbox.&lt;\\\/li&gt;\\n&lt;li&gt;Deselect the checkbox under &lt;strong&gt;Risk&lt;\\\/strong&gt;.\\n&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Make sure no capture delay is set:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;In your MPOS merchant account, go to &lt;strong&gt;Settings&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Account settings&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;From the &lt;strong&gt;POS Capture Delay&lt;\\\/strong&gt; list, select &lt;strong&gt;Immediate&lt;\\\/strong&gt;.\\n&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Contact our &lt;a href=\\&quot;https:\\\/\\\/ca-test.adyen.com\\\/ca\\\/ca\\\/contactUs\\\/support.shtml?form=other\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;Support Team&lt;\\\/a&gt; and ask them to configure the back-office for you. Let them know:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;The name of your MPOS merchant account.\\n&lt;\\\/li&gt;\\n&lt;li&gt;The name of the API credential you created for MPOS, so that they can enable the remaining roles.&lt;\\\/li&gt;\\n&lt;li&gt;Whether you process Givex or SVS gift cards.\\n&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:&quot;mpos_0_1&quot;,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;CPOS&quot;,&quot;content&quot;:&quot;\\n&lt;ol&gt;\\n&lt;li&gt;\\n&lt;p&gt;Log in to your &lt;a href=\\&quot;https:\\\/\\\/ca-test.adyen.com\\\/\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;Customer Area&lt;\\\/a&gt; and make sure you are on the company account level (in the top-right corner, under the name of your company account, &lt;em&gt;no merchant selected&lt;\\\/em&gt; is shown).&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Create a new API credential for CPOS:&lt;\\\/p&gt;\\n&lt;div class=\\&quot;notices yellow\\&quot;&gt;\\n&lt;p&gt;Do not use or configure the default API credential &lt;strong&gt;ws@Company.[YourCompanyAccount]&lt;\\\/strong&gt; that was created when you signed up with Adyen.&lt;\\\/p&gt;\\n&lt;\\\/div&gt;\\n&lt;ol&gt;\\n&lt;li&gt;\\n&lt;p&gt;Go to &lt;strong&gt;Developers&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;API credentials&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select &lt;strong&gt;Create new credential&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Under &lt;strong&gt;Credential type&lt;\\\/strong&gt;, select &lt;strong&gt;Web service&lt;\\\/strong&gt;. You can add a description here.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Make a note of the API credential name.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select &lt;strong&gt;Create credential&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Under &lt;strong&gt;Server settings&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Authentication&lt;\\\/strong&gt;, elect the &lt;strong&gt;API key&lt;\\\/strong&gt; tab.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select &lt;strong&gt;Generate API key&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Copy the API key using the copy icon &lt;i class=\\&quot;adl-icon-copy\\&quot;&gt;&lt;\\\/i&gt; and store your API key securely in your system.&lt;br \\\/&gt;\\nYou will need to add this API key in the Dynamics 365 configuration for CPOS.&lt;\\\/p&gt;\\n&lt;div class=\\&quot;notices yellow\\&quot;&gt;\\n&lt;p&gt;If you lose this API key you won&#039;t be able to restore it later.&lt;\\\/p&gt;\\n&lt;\\\/div&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Under &lt;strong&gt;Roles and Associated Accounts&lt;\\\/strong&gt;, enable the following roles:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;Merchant Recurring Role&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;p&gt;Our Support Team will enable more roles for you:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;POS initial Configuration&lt;\\\/li&gt;\\n&lt;li&gt;Terminal Registration Role&lt;\\\/li&gt;\\n&lt;li&gt;Terminal Management API Role&lt;\\\/li&gt;\\n&lt;li&gt;Device with Payload Encryption Role&lt;\\\/li&gt;\\n&lt;li&gt;Allow firmware download for POS devices\\n&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select &lt;strong&gt;Save changes&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Configure response settings:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;Switch to the merchant account you created for CPOS.&lt;\\\/li&gt;\\n&lt;li&gt;Go to &lt;strong&gt;Developers&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Additional data&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Select the &lt;strong&gt;Toggle all fields&lt;\\\/strong&gt; checkbox.&lt;\\\/li&gt;\\n&lt;li&gt;Deselect the checkbox under &lt;strong&gt;Risk&lt;\\\/strong&gt;.\\n&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Make sure no capture delay is set:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;In your CPOS merchant account, go to &lt;strong&gt;Settings&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Account settings&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;From the &lt;strong&gt;POS Capture Delay&lt;\\\/strong&gt; list, select &lt;strong&gt;Immediate&lt;\\\/strong&gt;.\\n&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Contact our &lt;a href=\\&quot;https:\\\/\\\/ca-test.adyen.com\\\/ca\\\/ca\\\/contactUs\\\/support.shtml?form=other\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;Support Team&lt;\\\/a&gt; and ask them to configure the back-office for you. Let them know:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;The name of your CPOS merchant account.\\n&lt;\\\/li&gt;\\n&lt;li&gt;The name of the API credential you created for CPOS, so that they can enable the remaining roles.&lt;\\\/li&gt;\\n&lt;li&gt;Whether you process Givex or SVS gift cards.\\n&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:&quot;cpos_1_2&quot;,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;eCommerce&quot;,&quot;content&quot;:&quot;\\n&lt;ol&gt;\\n&lt;li&gt;\\n&lt;p&gt;Log in to your &lt;a href=\\&quot;https:\\\/\\\/ca-test.adyen.com\\\/\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;Customer Area&lt;\\\/a&gt; and make sure you are on the company account level (in the top-right corner, under the name of your company account, &lt;em&gt;no merchant selected&lt;\\\/em&gt; is shown).&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Create a new API credential for eCommerce:&lt;\\\/p&gt;\\n&lt;div class=\\&quot;notices yellow\\&quot;&gt;\\n&lt;p&gt;Do not use or configure the default API credential &lt;strong&gt;ws@Company.[YourCompanyAccount]&lt;\\\/strong&gt; that was created when you signed up with Adyen.&lt;\\\/p&gt;\\n&lt;\\\/div&gt;\\n&lt;ol&gt;\\n&lt;li&gt;\\n&lt;p&gt;Go to &lt;strong&gt;Developers&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;API credentials&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select &lt;strong&gt;Create new credential&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Under &lt;strong&gt;Credential type&lt;\\\/strong&gt;, select &lt;strong&gt;Web service&lt;\\\/strong&gt;. You can add a description here.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Make a note of the API credential name.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select &lt;strong&gt;Create credential&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Under &lt;strong&gt;Server settings&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Authentication&lt;\\\/strong&gt;, elect the &lt;strong&gt;API key&lt;\\\/strong&gt; tab.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select &lt;strong&gt;Generate API key&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Copy the API key using the copy icon &lt;i class=\\&quot;adl-icon-copy\\&quot;&gt;&lt;\\\/i&gt; and store your API key securely in your system.&lt;br \\\/&gt;\\nYou will need to add this API key in the Dynamics 365 configuration for eCommerce.&lt;\\\/p&gt;\\n&lt;div class=\\&quot;notices yellow\\&quot;&gt;\\n&lt;p&gt;If you lose this API key you won&#039;t be able to restore it later.&lt;\\\/p&gt;\\n&lt;\\\/div&gt;\\n&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Under &lt;strong&gt;Roles and Associated Accounts&lt;\\\/strong&gt;, enable the following roles:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;API Clientside Encryption Payments Role&lt;\\\/li&gt;\\n&lt;li&gt;API Payment RefundWithData&lt;\\\/li&gt;\\n&lt;li&gt;Checkout encrypted cardholder data&lt;\\\/li&gt;\\n&lt;li&gt;Checkout Webservice role&lt;\\\/li&gt;\\n&lt;li&gt;General API Payments Role&lt;\\\/li&gt;\\n&lt;li&gt;Merchant PAL Webservice Role&lt;\\\/li&gt;\\n&lt;li&gt;Merchant Recurring Role&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;If you use V002 of the Adyen payment connector:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;Under &lt;strong&gt;Origin key&lt;\\\/strong&gt;, enter your website&#039;s domain, then select &lt;strong&gt;Generate Origin Key&lt;\\\/strong&gt;.&lt;br \\\/&gt;\\nUse a concatenation of the protocol, host, and port. Do not include subdirectories or a trailing slash. For example, &lt;strong&gt;https&amp;#58;\\\/\\\/your-company.example.com&lt;\\\/strong&gt; or &lt;strong&gt;https&amp;#58;\\\/\\\/checkout.your-company.example.com:8080&lt;\\\/strong&gt;. You can also confirm this by opening the browser console and calling window.location.origin.&lt;\\\/li&gt;\\n&lt;li&gt;Copy and safely store the origin key in your system. You will need to add this key in the Dynamics 365 configuration.\\n&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select &lt;strong&gt;Save changes&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Configure response settings:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;Switch to the merchant account you created for eCommerce.&lt;\\\/li&gt;\\n&lt;li&gt;Go to &lt;strong&gt;Developers&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Additional data&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Select the &lt;strong&gt;Toggle all fields&lt;\\\/strong&gt; checkbox.&lt;\\\/li&gt;\\n&lt;li&gt;Deselect the checkbox under &lt;strong&gt;Risk&lt;\\\/strong&gt;.\\n&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Contact our &lt;a href=\\&quot;https:\\\/\\\/ca-test.adyen.com\\\/ca\\\/ca\\\/contactUs\\\/support.shtml?form=other\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;Support Team&lt;\\\/a&gt; and ask them to configure the back-office for you. Let them know:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;The name of your eCommerce merchant account.\\n&lt;\\\/li&gt;\\n&lt;li&gt;Whether you process unreferenced refunds.&lt;\\\/li&gt;\\n&lt;li&gt;Whether you process Givex or SVS gift cards.\\n&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:&quot;ecommerce_2_3&quot;,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;Call Center&quot;,&quot;content&quot;:&quot;\\n&lt;ol&gt;\\n&lt;li&gt;\\n&lt;p&gt;Log in to your &lt;a href=\\&quot;https:\\\/\\\/ca-test.adyen.com\\\/\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;Customer Area&lt;\\\/a&gt; and make sure you are on the company account level (in the top-right corner, under the name of your company account, &lt;em&gt;no merchant selected&lt;\\\/em&gt; is shown).&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Create a new API credential for Call Center:&lt;\\\/p&gt;\\n&lt;div class=\\&quot;notices yellow\\&quot;&gt;\\n&lt;p&gt;Do not use or configure the default API credential &lt;strong&gt;ws@Company.[YourCompanyAccount]&lt;\\\/strong&gt; that was created when you signed up with Adyen.&lt;\\\/p&gt;\\n&lt;\\\/div&gt;\\n&lt;ol&gt;\\n&lt;li&gt;\\n&lt;p&gt;Go to &lt;strong&gt;Developers&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;API credentials&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select &lt;strong&gt;Create new credential&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Under &lt;strong&gt;Credential type&lt;\\\/strong&gt;, select &lt;strong&gt;Web service&lt;\\\/strong&gt;. You can add a description here.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Make a note of the API credential name.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select &lt;strong&gt;Create credential&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Under &lt;strong&gt;Server settings&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Authentication&lt;\\\/strong&gt;, elect the &lt;strong&gt;API key&lt;\\\/strong&gt; tab.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select &lt;strong&gt;Generate API key&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Copy the API key using the copy icon &lt;i class=\\&quot;adl-icon-copy\\&quot;&gt;&lt;\\\/i&gt; and store your API key securely in your system.&lt;br \\\/&gt;\\nYou will need to add this API key in the Dynamics 365 configuration for Call Center.&lt;\\\/p&gt;\\n&lt;div class=\\&quot;notices yellow\\&quot;&gt;\\n&lt;p&gt;If you lose this API key you won&#039;t be able to restore it later.&lt;\\\/p&gt;\\n&lt;\\\/div&gt;\\n&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Under &lt;strong&gt;Roles and Associated Accounts&lt;\\\/strong&gt;, enable the following roles:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;API Clientside Encryption Payments Role&lt;\\\/li&gt;\\n&lt;li&gt;Checkout encrypted cardholder data&lt;\\\/li&gt;\\n&lt;li&gt;Checkout Webservice role&lt;\\\/li&gt;\\n&lt;li&gt;General API Payments Role&lt;\\\/li&gt;\\n&lt;li&gt;Merchant PAL Webservice Role&lt;\\\/li&gt;\\n&lt;li&gt;Merchant Recurring Role\\n&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Select &lt;strong&gt;Save changes&lt;\\\/strong&gt;.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Configure response settings:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;Switch to the merchant account you created for Call Center.&lt;\\\/li&gt;\\n&lt;li&gt;Go to &lt;strong&gt;Developers&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Additional data&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Select the &lt;strong&gt;Toggle all fields&lt;\\\/strong&gt; checkbox.&lt;\\\/li&gt;\\n&lt;li&gt;Deselect the checkbox under &lt;strong&gt;Risk&lt;\\\/strong&gt;.\\n&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Contact our &lt;a href=\\&quot;https:\\\/\\\/ca-test.adyen.com\\\/ca\\\/ca\\\/contactUs\\\/support.shtml?form=other\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;Support Team&lt;\\\/a&gt; and ask them to configure the back-office for you. Let them know:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;The name of your Call Center merchant account.\\n&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:&quot;call_center_3_4&quot;,&quot;relation&quot;:&quot;&quot;}]\"\n            :should-update-when-url-changes='false'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n<h2 id=\"get-adyen-terminals\">Step 2 (MPOS or CPOS): Get your Adyen payment terminals<\/h2>\n<p>For your MPOS or CPOS channel, the Adyen payment connector can only communicate with payment terminals that are injected with Adyen software. To obtain these terminals:<\/p>\n<ol>\n<li><a href=\"\/pt\/point-of-sale\/design-your-integration\/determine-account-structure\/#create-stores\">Create store IDs<\/a> for the stores where you are using MPOS or CPOS.<\/li>\n<li><a href=\"\/pt\/point-of-sale\/what-we-support\/select-your-terminals\">Select the terminal models<\/a> that suit your business.<\/li>\n<li><a href=\"\/pt\/point-of-sale\/managing-terminals\/order-terminals#sales-order-steps\">Order test terminals<\/a> and a test card from your test Customer Area.<\/li>\n<li><a href=\"\/pt\/point-of-sale\/managing-terminals\/board-terminal\">Board your terminals<\/a> to associate them with a store and make them ready to accept test payments.<\/li>\n<\/ol>\n<h2 id=\"set-up-dynamics\">Step 3: Set up Dynamics 365<\/h2>\n<p>To set up and configure the Adyen payment connector in Dynamics 365 Commerce:<\/p>\n<ol>\n<li>\n<p>Follow the instructions in the <a href=\"https:\/\/docs.microsoft.com\/en-us\/dynamics365\/commerce\/dev-itpro\/adyen-connector?tabs=8-1-3\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Dynamics 365 Commerce documentation<\/a>.<\/p>\n<\/li>\n<li>\n<p>For e-Commerce and Call Center: When requested to specify the <strong>Optional Domain<\/strong>, you can leave this field blank for the test environment. But when going live you must provide your Adyen merchant prefix, otherwise you get a <code>PaymentException<\/code> error. To find your merchant prefix:<\/p>\n<ol>\n<li>Log in to your <a href=\"https:\/\/ca-live.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">live Customer Area<\/a> and select your merchant account.<\/li>\n<li>\n<p>Go to <strong>Developers<\/strong> &gt; <strong>API URLs<\/strong>. The merchant prefix is a value formatted like this example: <code>de05272d410af88d-YOUR_COMPANY<\/code>.<\/p>\n<!-- list separator -->\n<\/li>\n<\/ol>\n<\/li>\n<li>\n<p>For CPOS: When requested to specify the <strong>Optional Domain<\/strong>, you can leave the field blank in the test environment. When going live, specify <code>https:\/\/terminal-api-live.adyen.com\/sync<\/code>.<\/p>\n<\/li>\n<li>\n<p>When requested to set up a <strong>POS hardware profile<\/strong> for the Adyen payment terminals you are using with MPOS or CPOS, find the required values as follows:<\/p>\n<ol>\n<li>Log in to your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>.<\/li>\n<li>Go to <strong>In-person payments<\/strong> &gt; <strong>Terminals<\/strong> and select your terminal.<\/li>\n<li>\n<p>On the <strong>Settings<\/strong> page, find:<\/p>\n<ul>\n<li>The terminal's IP address under <strong>Connectivity<\/strong>.<\/li>\n<li>The POIID, in the format <em>[device model]-[serial number]<\/em>, in the page title.<\/li>\n<li>\n<p>The Key identifier, Key passphrase, and Key version under <strong>Integrations<\/strong> &gt; <strong>Encryption key<\/strong>.<\/p>\n<!-- list separator -->\n<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n<h2>Tokenization<\/h2>\n<p>The Adyen payment connector supports <a href=\"\/pt\/get-started-with-adyen\/adyen-glossary\/#tokenization-definition\">tokenization<\/a>, but this functionality requires some configuration on our end. Contact our <a href=\"https:\/\/ca-test.adyen.com\/ca\/ca\/contactUs\/support.shtml?form=other\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Support Team<\/a> to enable tokenization.<\/p>\n<h2>Test and go live<\/h2>\n<h3>Test your integration<\/h3>\n<p>Before you start accepting payments, test your integration:<\/p>\n<ol>\n<li>\n<p>Use our <a href=\"\/pt\/development-resources\/test-cards-and-credentials\/test-card-numbers\">test card numbers<\/a> to test online payments and\/or use your test terminal and test card to test in-person payments.<\/p>\n<div class=\"sc-notice info\"><div>\n<p>To test Givex gift cards, ask your Givex contact for the credentials to supply to Adyen.<\/p>\n<p>When a test gift card needs to be reset, contact the provider (SVS or Givex).<\/p>\n<\/div><\/div>\n<\/li>\n<li>\n<p>Test all the payment methods that you want to offer in each channel that you are using.<\/p>\n<\/li>\n<li>\n<p>Review details on each test payment in your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">test Customer Area<\/a>.<\/p>\n<\/li>\n<\/ol>\n<h3>Go live<\/h3>\n<p>When you have a live Adyen account and the credentials for your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">test Customer Area<\/a>:<\/p>\n<ol>\n<li>If you use more than one sales channel, for example MPOS and e-Commerce, <a href=\"\/pt\/account\/manage-account-structure#request-merchant-account\">request additional merchant accounts<\/a>. You need have a separate live merchant account for each channel.<\/li>\n<li>If you are using MPOS or CPOS:\n<ol>\n<li><a href=\"\/pt\/point-of-sale\/design-your-integration\/determine-account-structure\/#create-stores\">Create store IDs<\/a> under your live merchant account.<\/li>\n<li><a href=\"\/pt\/point-of-sale\/managing-terminals\/order-terminals#sales-order-steps\">Order live terminals<\/a> from your live Customer Area.<\/li>\n<li><a href=\"\/pt\/point-of-sale\/managing-terminals\/board-terminal\">Board your terminals<\/a> to make them ready to accept live payments.<\/li>\n<\/ol><\/li>\n<li>Configure your live Adyen account as described in <a href=\"#adyen-configuration\">Step 1<\/a>.<\/li>\n<li>In Dynamics 365 Headquarters, do the following:\n<ul>\n<li>Set <strong>Gateway environment<\/strong> to <strong>Live<\/strong>.<\/li>\n<li>Enter the <strong>Optional Domain<\/strong>. Refer to <a href=\"#set-up-dynamics\">Step 3<\/a> and the <a href=\"https:\/\/docs.microsoft.com\/en-us\/dynamics365\/commerce\/dev-itpro\/adyen-connector?tabs=10-0-11#prerequisites\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Prerequisites<\/a> in the Dynamics 365 documentation for the Adyen payment connector.<\/li>\n<\/ul><\/li>\n<\/ol>","url":"https:\/\/docs.adyen.com\/pt\/plugins\/microsoft-dynamics","articleFields":{"description":"Set up the Adyen payment connector for Dynamics 365","last_edit_on":"27-03-2023 09:14","feedback_component":true,"filters_component":false},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/plugins\/microsoft-dynamics","title":"Microsoft Dynamics 365","content":"\n&nbsp; Read moreLearn more about Microsoft Dynamics 365 in our Partner Directory.\n\nWhen you use Microsoft Dynamics 365 Commerce as your omnichannel solution, the Dynamics 365 Payment Connector for Adyen allows you to process payments across your sales channels through the plataforma de pagamentos da Adyen. With the Adyen payment connector you can accept:\n\nAll major global credit and debit cards, both online and in-store.\nPoint-of-sale transactions with Givex and SVS gift cards.\nPoint-of-sale transactions with Android Pay, Apple Pay, and Samsung Pay wallets.\n\nYou can use the Adyen payment connector with all Dynamics 365 Commerce channels:\n\nModern POS (MPOS) - Interfaces with the Adyen Terminal API using local communications. It allows you to continue processing payments when offline, and to access payment terminals, printers, and cash drawers directly.\nCloud POS (CPOS) - Interfaces with the Adyen Terminal API using cloud communications. It runs in a browser and therefore cannot work offline and can only access the payment terminals, printers, and cash drawers through a hardware station.\ne-Commerce - Interfaces with the Adyen Checkout API.\nCall Center - Interfaces with the Adyen Checkout API.\n\nRequirements\nBefore you begin to integrate, make sure you have followed the Get started with Adyen guide to:\n\nGet an overview of the steps needed to accept live payments.\nCreate your test account.\n\nIf you use more than one sales channel, for example MPOS and e-Commerce, request additional merchant accounts. You need to have a separate merchant account for each channel.\nWhile you wait for your application for a live account to be approved, you can:\n\nConfigure your Adyen account.\nOrder Adyen payment terminals for your MPOS or CPOS retail channel (if applicable).\nSet up the Adyen payment connector in Dynamics 365.\n\nStep 1: Configure your Adyen account\nOur Support Team will take care of part of your account configuration. But there are a few steps that you need to do yourself. The most important step is to create separate API credentials for each of your sales channels.\nSelect the following tabs to see what you need to do for MPOS, CPOS, e-Commerce, or Call Center.\n\n\n    \n        \n        \n    \n\n\nStep 2 (MPOS or CPOS): Get your Adyen payment terminals\nFor your MPOS or CPOS channel, the Adyen payment connector can only communicate with payment terminals that are injected with Adyen software. To obtain these terminals:\n\nCreate store IDs for the stores where you are using MPOS or CPOS.\nSelect the terminal models that suit your business.\nOrder test terminals and a test card from your test Customer Area.\nBoard your terminals to associate them with a store and make them ready to accept test payments.\n\nStep 3: Set up Dynamics 365\nTo set up and configure the Adyen payment connector in Dynamics 365 Commerce:\n\n\nFollow the instructions in the Dynamics 365 Commerce documentation.\n\n\nFor e-Commerce and Call Center: When requested to specify the Optional Domain, you can leave this field blank for the test environment. But when going live you must provide your Adyen merchant prefix, otherwise you get a PaymentException error. To find your merchant prefix:\n\nLog in to your live Customer Area and select your merchant account.\n\nGo to Developers &gt; API URLs. The merchant prefix is a value formatted like this example: de05272d410af88d-YOUR_COMPANY.\n\n\n\n\n\nFor CPOS: When requested to specify the Optional Domain, you can leave the field blank in the test environment. When going live, specify https:\/\/terminal-api-live.adyen.com\/sync.\n\n\nWhen requested to set up a POS hardware profile for the Adyen payment terminals you are using with MPOS or CPOS, find the required values as follows:\n\nLog in to your Customer Area.\nGo to In-person payments &gt; Terminals and select your terminal.\n\nOn the Settings page, find:\n\nThe terminal's IP address under Connectivity.\nThe POIID, in the format [device model]-[serial number], in the page title.\n\nThe Key identifier, Key passphrase, and Key version under Integrations &gt; Encryption key.\n\n\n\n\n\n\n\nTokenization\nThe Adyen payment connector supports tokenization, but this functionality requires some configuration on our end. Contact our Support Team to enable tokenization.\nTest and go live\nTest your integration\nBefore you start accepting payments, test your integration:\n\n\nUse our test card numbers to test online payments and\/or use your test terminal and test card to test in-person payments.\n\nTo test Givex gift cards, ask your Givex contact for the credentials to supply to Adyen.\nWhen a test gift card needs to be reset, contact the provider (SVS or Givex).\n\n\n\nTest all the payment methods that you want to offer in each channel that you are using.\n\n\nReview details on each test payment in your test Customer Area.\n\n\nGo live\nWhen you have a live Adyen account and the credentials for your test Customer Area:\n\nIf you use more than one sales channel, for example MPOS and e-Commerce, request additional merchant accounts. You need have a separate live merchant account for each channel.\nIf you are using MPOS or CPOS:\n\nCreate store IDs under your live merchant account.\nOrder live terminals from your live Customer Area.\nBoard your terminals to make them ready to accept live payments.\n\nConfigure your live Adyen account as described in Step 1.\nIn Dynamics 365 Headquarters, do the following:\n\nSet Gateway environment to Live.\nEnter the Optional Domain. Refer to Step 3 and the Prerequisites in the Dynamics 365 documentation for the Adyen payment connector.\n\n","type":"page","locale":"pt","boost":18,"hierarchy":{"lvl0":"Home","lvl1":"Plugins","lvl2":"Microsoft Dynamics 365"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/plugins","lvl2":"\/pt\/plugins\/microsoft-dynamics"},"levels":3,"category":"Plugins","category_color":"green","tags":["Microsoft","Dynamics"]},"articleFiles":{"dynamics_logo.svg":"<img style=\"width: 38px;\" alt=\"\" src=\"https:\/\/docs.adyen.com\/user\/pages\/docs\/05.plugins\/26.microsoft-dynamics\/dynamics_logo.svg?decoding=auto&amp;fetchpriority=auto\" \/>"}}