{"title":"Set up the plugin","category":"default","creationDate":1674038040,"content":"<p>Follow the steps below to set up the CPOS plugin in your Adyen Customer Area and the Cegid Retail Y2 back office. After you have completed the setup steps, <a href=\"#test-integration\">test your integration<\/a> to make sure the plugin works correctly.<\/p>\n<p>After you are done testing, follow the <a href=\"#go-live\">steps to go live with your integration<\/a>.<\/p>\n<h2 id=\"download-and-install-the-plugin\">Step 1: Download and install the plugin<\/h2>\n<p>Download the plugin:<\/p>\n<ol>\n<li>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 receive the password for the plugin installation file.<\/li>\n<li>Only if you have already integrated with the plugin and are downloading to upgrade to a later version:<br \/>\na. Uninstall older versions of the plugin.<br \/>\nb. Reboot the device that Cegid Retail Y2 is installed on.<\/li>\n<li>Download and unzip the password protected <a href=\"\/pt\/plugins\/cegid-retail-y2\/set-up-the-plugin\/Cegid-Plugin-v2.1.26.zip\">Cegid Retail Y2 CPOS plugin installation file<\/a> for <a href=\"\/pt\/plugins\/release-notes?title%5B0%5D=Cegid%20Retail%20Y2\">v2.1.26<\/a>.<\/li>\n<\/ol>\n<p>Install the plugin:<\/p>\n<ol>\n<li>Run the <code>Setup_Retailstars.CAT.ADYEN.MULTI_2.1.*.exe<\/code> file.<\/li>\n<li>When prompted to select a setup language, select <strong>English<\/strong> and then select <strong>OK<\/strong>.<\/li>\n<li>The installation path defaults to <code>C:\\Program Files (x86)\\Retailstars\\CPOS<\/code>, in the <strong>Folder Exists<\/strong> pop-up window, select <strong>Yes<\/strong>.<\/li>\n<li>Double-check that the <strong>Destination location<\/strong> is set to the correct installation path. You can only change the installation directory of CPOS by uninstalling and reinstalling after installation is complete.<\/li>\n<li>Select <strong>Install<\/strong>.<\/li>\n<li>When the installation is complete, select <strong>Finish<\/strong>.<\/li>\n<\/ol>\n<p>Check if the plugin is connected to Cegid Retail Y2 correctly:<\/p>\n<ol>\n<li>In the Cegid Retail Y2 back office, go to <strong>Settings<\/strong> &gt; <strong>Registers<\/strong> and select your register.<\/li>\n<li>Select <strong>Settings for Peripheral<\/strong> and then select <strong>EPT<\/strong>.<\/li>\n<li>\n<p>Check if the following values are set correctly:<\/p>\n<ul>\n<li>DLL name: <strong>Retailstars.CAT.CPOS.ADYEN.MULTI<\/strong><\/li>\n<li>Driver name: <strong>ADYEN.MULTI<\/strong><\/li>\n<\/ul>\n<p>If required, manually set the correct values.<\/p>\n<\/li>\n<li>If you want to process payments with gift cards, set the <strong>Identifier<\/strong> to <strong>1<\/strong>.<\/li>\n<\/ol>\n<h2 id=\"configure-adyen\">Step 2: Configure your Adyen account<\/h2>\n<p>For this task, you must have the following <a href=\"\/pt\/account\/user-roles\">user role<\/a>:<\/p>\n<ul>\n<li>Merchant POS Terminal Management Admin role<\/li>\n<\/ul>\n\n<div id=\"tabL73kp\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;Local communications&quot;,&quot;content&quot;:&quot;\\n&lt;ol&gt;\\n&lt;li&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, no merchant account is shown).&lt;\\\/li&gt;\\n&lt;li&gt;Go to &lt;strong&gt;In-person payments&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Terminal settings&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Integrations&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Under &lt;strong&gt;Terminal API&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Enable terminal API&lt;\\\/strong&gt;, select &lt;strong&gt;Enabled&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Under &lt;strong&gt;Encryption key&lt;\\\/strong&gt; select &lt;strong&gt;Decrypted&lt;\\\/strong&gt; and then complete the fields:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;&lt;strong&gt;Key identifier&lt;\\\/strong&gt;: a description to recognize the key by.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;strong&gt;Key passphrase&lt;\\\/strong&gt;: a string of random characters.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;strong&gt;Key version&lt;\\\/strong&gt;: the version number of the key. For example, &lt;strong&gt;1&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;div class=\\&quot;notices green\\&quot;&gt;\\n&lt;p&gt;If this section is not visible or if you cannot edit the fields, ask 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; to set the required permission for your user.&lt;\\\/p&gt;\\n&lt;\\\/div&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;Save&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Securely store the key identifier, passphrase, and version in your system. If you use local communications, you need these values when you are &lt;a href=\\&quot;#configure-cegid\\&quot;&gt;setting up the plugin in Cegid Retail Y2&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:&quot;local_communications_0_1&quot;,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;Cloud communications&quot;,&quot;content&quot;:&quot;\\n&lt;ol&gt;\\n&lt;li&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, no merchant account is shown).&lt;\\\/li&gt;\\n&lt;li&gt;Create a new API credential:\\n&lt;ol&gt;\\n&lt;li&gt;Go to &lt;strong&gt;Developers&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;API credentials&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;Create new credential&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&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;\\\/li&gt;\\n&lt;li&gt;Make a note of the API credential name.&lt;\\\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;Create credential&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&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;\\\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;Generate API key&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&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;\\\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;Save changes.&lt;\\\/strong&gt;&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;&lt;\\\/li&gt;\\n&lt;li&gt;Go to &lt;strong&gt;In-person payments&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Terminal settings&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Integrations&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Terminal API&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Under &lt;strong&gt;Enable terminal API&lt;\\\/strong&gt;, select &lt;strong&gt;Enabled&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Select &lt;strong&gt;Save&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&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; to toggle the &lt;strong&gt;Enable WebSockets&lt;\\\/strong&gt; feature.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:&quot;cloud_communications_1_2&quot;,&quot;relation&quot;:&quot;&quot;}]\"\n            :should-update-when-url-changes='false'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n<h2>Step 3: Get your Adyen payment terminals<\/h2>\n<p>The plugin can only communicate with 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 want the plugin to accept payments.<\/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=\"configure-cegid\">Step 4: Set up the plugin in Cegid Retail Y2<\/h2>\n<p>To configure the CPOS plugin in the Cegid Retail Y2 back office:<\/p>\n<ol>\n<li>\n<p>In the Cegid Retail Y2 back office, go to <strong>Settings<\/strong> &gt; <strong>Registers<\/strong> and select your register.<\/p>\n<\/li>\n<li>\n<p>Select <strong>Settings for Peripheral<\/strong> and select <strong>EPT<\/strong>.<\/p>\n<\/li>\n<li>\n<p>Select <strong>Settings for Peripheral<\/strong> and fill these properties:<\/p>\n\n<div id=\"tabezBXH\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;Local communications&quot;,&quot;content&quot;:&quot;\\n&lt;table&gt;\\n&lt;thead&gt;\\n&lt;tr&gt;\\n&lt;th&gt;Field&lt;\\\/th&gt;\\n&lt;th style=\\&quot;text-align: center;\\&quot;&gt;Required&lt;\\\/th&gt;\\n&lt;th&gt;Description&lt;\\\/th&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/thead&gt;\\n&lt;tbody&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Default Language&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-white_check_mark-\\&quot; alt=\\&quot;-white_check_mark-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/white_check_mark.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The language you want to use for your terminals and plugin.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Logfile DCPP Layer&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-white_check_mark-\\&quot; alt=\\&quot;-white_check_mark-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/white_check_mark.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The path to the logging file for communication between Cegid Retail Y2 and the plugin. For example: &lt;strong&gt;YOUR_CEGID_INSTALL_DIRECTORY\\\\CPOS\\\\Retailstars.CAT.ADYEN.MULTI\\\\Log\\\\DCPP&lt;\\\/strong&gt;.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Logfile DRV Layer&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-white_check_mark-\\&quot; alt=\\&quot;-white_check_mark-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/white_check_mark.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The path to the logging file for communication between the plugin and Adyen. For example: &lt;strong&gt;YOUR_CEGID_INSTALL_DIRECTORY\\\\CPOS\\\\Retailstars.CAT.ADYEN.MULTI\\\\Log\\\\DRV&lt;\\\/strong&gt;.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Directory Licence + Config&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-x-\\&quot; alt=\\&quot;-x-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/x.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The directory where the configuration can be read or files can be stored temporarily, for example the custom translation file. For example: &lt;strong&gt;YOUR_CEGID_INSTALLATION_PATH\\\\Front Office\\\\CPOS_Pilotes\\\\Retailstars.CAT.ADYEN.MULTI\\\\Config&lt;\\\/strong&gt;.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Wait After Transaction Success&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-x-\\&quot; alt=\\&quot;-x-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/x.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The waiting time of your terminals after each payment before the next payment can be accepted. Set to &lt;strong&gt;0&lt;\\\/strong&gt; if no waiting time is required, &lt;strong&gt;-1&lt;\\\/strong&gt; to wait until cashier confirmation, or set to a positive number to specify a waiting time in seconds.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Printer ID for Payment Receipt&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-x-\\&quot; alt=\\&quot;-x-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/x.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The ID of the printer where the payment receipts should be printed to. When set to &lt;strong&gt;0&lt;\\\/strong&gt;, the receipt is printed to the screen.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Payment Receipt Model&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-x-\\&quot; alt=\\&quot;-x-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/x.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The model of the payment receipt that will be printed. You can leave the default setting or set it to &lt;strong&gt;ON1&lt;\\\/strong&gt;, &lt;strong&gt;Z01&lt;\\\/strong&gt;, or &lt;strong&gt;Z09&lt;\\\/strong&gt;.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Allow Booking of Undetermined Payment&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-x-\\&quot; alt=\\&quot;-x-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/x.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;When enabled, this setting will allow accepting a payment with an unknown result after a failed transaction.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Payment configuration&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-white_check_mark-\\&quot; alt=\\&quot;-white_check_mark-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/white_check_mark.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;Default value: &lt;strong&gt;D:CP,RR&lt;\\\/strong&gt;  &lt;br\\\/&gt; If you want the default refund type to be &lt;a href=\\&quot;#refunds\\&quot;&gt;unreferenced&lt;\\\/a&gt;, set to &lt;strong&gt;D:CP,NR&lt;\\\/strong&gt;. &lt;br\\\/&gt; For documentation on advanced use cases, refer to the documentation file in the installation folder.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;URL&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-white_check_mark-\\&quot; alt=\\&quot;-white_check_mark-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/white_check_mark.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;Set to &lt;code&gt;https:\\\/\\\/YOUR_DEVICE_IP:8443\\\/nexo&lt;\\\/code&gt;.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Connection Type&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-white_check_mark-\\&quot; alt=\\&quot;-white_check_mark-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/white_check_mark.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;Set to &lt;strong&gt;Local&lt;\\\/strong&gt;.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Sale ID&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-white_check_mark-\\&quot; alt=\\&quot;-white_check_mark-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/white_check_mark.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The unique ID that will be used in your API requests for your POS, for example &lt;strong&gt;Register1&lt;\\\/strong&gt;.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;POI ID&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-white_check_mark-\\&quot; alt=\\&quot;-white_check_mark-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/white_check_mark.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The unique ID of your Adyen terminal that you can find in 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;. Go to &lt;strong&gt;In-person payments&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Terminals&lt;\\\/strong&gt; and select your terminal. Your &lt;strong&gt;POIID&lt;\\\/strong&gt; in Cegid Retail Y2 is the &lt;strong&gt;Permanent terminal ID&lt;\\\/strong&gt;.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Key Identifier&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-white_check_mark-\\&quot; alt=\\&quot;-white_check_mark-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/white_check_mark.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The key identifier value you set in 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; in &lt;a href=\\&quot;#configure-adyen\\&quot;&gt;Step 1&lt;\\\/a&gt;.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Key Passphrase&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-white_check_mark-\\&quot; alt=\\&quot;-white_check_mark-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/white_check_mark.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The key passphrase value you set in 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; in &lt;a href=\\&quot;#configure-adyen\\&quot;&gt;Step 1&lt;\\\/a&gt;.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Key Version&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-white_check_mark-\\&quot; alt=\\&quot;-white_check_mark-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/white_check_mark.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The key version value you set in 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; in &lt;a href=\\&quot;#configure-adyen\\&quot;&gt;Step 1&lt;\\\/a&gt;.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Transaction TimeOut&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-x-\\&quot; alt=\\&quot;-x-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/x.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The transaction time-out in seconds. The default value for the transaction timeout is &lt;strong&gt;120&lt;\\\/strong&gt; seconds.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Request\\\/Response TimeOut&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-x-\\&quot; alt=\\&quot;-x-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/x.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The internal timeout duration for the terminal. The default value for the request\\\/response timeout is &lt;strong&gt;3&lt;\\\/strong&gt; seconds.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Nbr Customer Payment Receipts&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-x-\\&quot; alt=\\&quot;-x-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/x.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The number of customer payment receipts printed by the printer. Use the default value &lt;strong&gt;0&lt;\\\/strong&gt; if the terminal prints the receipts. If you want to enable the optional printing prompt for approved transactions, set to &lt;strong&gt;-1&lt;\\\/strong&gt;.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Nbr Merchant Payment Receipts&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-x-\\&quot; alt=\\&quot;-x-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/x.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The number of merchant payment receipts printed by the printer. Use the default value &lt;strong&gt;0&lt;\\\/strong&gt; if the terminal prints the receipts.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Default Currency&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-x-\\&quot; alt=\\&quot;-x-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/x.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The default payment currency for your store.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Enable End Of Day&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-x-\\&quot; alt=\\&quot;-x-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/x.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;When selected, the plugin will prompt the cashier to print an end of day total when closing a sales day.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Prompt For Signature&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-x-\\&quot; alt=\\&quot;-x-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/x.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;When selected, the plugin will prompt the cashier to validate the signature of the shopper.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Legacy Mode&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-x-\\&quot; alt=\\&quot;-x-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/x.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;Deselected by default. Do not enable unless instructed by your Cegid contact.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Ignore Void&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-x-\\&quot; alt=\\&quot;-x-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/x.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The default behavior of the plugin for Void requests. It is recommended to set this value to &lt;strong&gt;Confirm Void&lt;\\\/strong&gt;. This will prompt the cashier to explicitly confirm or reject void by typing &lt;strong&gt;Yes&lt;\\\/strong&gt; or &lt;strong&gt;No&lt;\\\/strong&gt; in a text field.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/tbody&gt;\\n&lt;\\\/table&gt;\\n&quot;,&quot;altTitle&quot;:&quot;local&quot;,&quot;oldTabId&quot;:&quot;local_1&quot;,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;Cloud communications&quot;,&quot;content&quot;:&quot;\\n&lt;table&gt;\\n&lt;thead&gt;\\n&lt;tr&gt;\\n&lt;th&gt;Field&lt;\\\/th&gt;\\n&lt;th style=\\&quot;text-align: center;\\&quot;&gt;Required&lt;\\\/th&gt;\\n&lt;th&gt;Description&lt;\\\/th&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/thead&gt;\\n&lt;tbody&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Default Language&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-white_check_mark-\\&quot; alt=\\&quot;-white_check_mark-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/white_check_mark.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The language you want to use for your terminals and plugin.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Logfile DCPP Layer&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-white_check_mark-\\&quot; alt=\\&quot;-white_check_mark-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/white_check_mark.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The path to the logging file for communication between Cegid Retail Y2 and the plugin. For example: &lt;strong&gt;YOUR_CEGID_INSTALLATION_PATH\\\\FrontOffice\\\\CPOS_Pilotes\\\\Retailstars.CAT.ADYEN.MULTI\\\\Log\\\\DCPP&lt;\\\/strong&gt;.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Logfile DRV Layer&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-white_check_mark-\\&quot; alt=\\&quot;-white_check_mark-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/white_check_mark.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The path to the logging file for communication between the plugin and Adyen. For example: &lt;strong&gt;YOUR_CEGID_INSTALLATION_PATH\\\\FrontOffice\\\\CPOS_Pilotes\\\\Retailstars.CAT.ADYEN.MULTI\\\\Log\\\\DRV&lt;\\\/strong&gt;.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Directory Licence + Config&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-x-\\&quot; alt=\\&quot;-x-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/x.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The directory where the configuration can be read or files can be stored temporarily, for example the custom translation file. For example: &lt;strong&gt;YOUR_CEGID_INSTALLATION_PATH\\\\Front Office\\\\CPOS_Pilotes\\\\Retailstars.CAT.ADYEN.MULTI\\\\Config&lt;\\\/strong&gt;.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Wait After Transaction Success&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-x-\\&quot; alt=\\&quot;-x-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/x.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The waiting time of your terminals after each payment before the next payment can be accepted. Set to &lt;strong&gt;0&lt;\\\/strong&gt; if no waiting time is required, &lt;strong&gt;-1&lt;\\\/strong&gt; to wait until cashier confirmation and a positive number to specify a waiting time in seconds.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Printer ID for Payment Receipt&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-x-\\&quot; alt=\\&quot;-x-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/x.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The ID of the printer where the payment receipts should be printed to. When set to &lt;strong&gt;0&lt;\\\/strong&gt;, the receipt is printed to the screen.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Payment Receipt Model&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-x-\\&quot; alt=\\&quot;-x-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/x.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The model of the payment receipt that will be printed. You can leave the default setting or set it to &lt;strong&gt;ON1&lt;\\\/strong&gt;, &lt;strong&gt;Z01&lt;\\\/strong&gt;, or &lt;strong&gt;Z09&lt;\\\/strong&gt;.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Allow Booking of Undetermined Payment&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-x-\\&quot; alt=\\&quot;-x-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/x.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;When enabled, this setting will allow accepting a payment with an unknown result after a failed transaction.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Payment configuration&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-white_check_mark-\\&quot; alt=\\&quot;-white_check_mark-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/white_check_mark.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;Default value: &lt;strong&gt;D:CP,RR&lt;\\\/strong&gt;  &lt;br\\\/&gt; If you want the default refund type to be &lt;a href=\\&quot;#refunds\\&quot;&gt;unreferenced&lt;\\\/a&gt;, set to &lt;strong&gt;D:CP,NR&lt;\\\/strong&gt;. &lt;br\\\/&gt; For documentation on advanced use cases, refer to the documentation file in the installation folder.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;URL&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-white_check_mark-\\&quot; alt=\\&quot;-white_check_mark-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/white_check_mark.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;For your test integration, set to &lt;strong&gt;&lt;a href=\\&quot;https:\\\/\\\/terminal-api-test.adyen.com\\\/sync\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;https:\\\/\\\/terminal-api-test.adyen.com\\\/sync&lt;\\\/a&gt;&lt;\\\/strong&gt;. For your live integration, set to the &lt;a href=\\&quot;\\\/pt\\\/point-of-sale\\\/design-your-integration\\\/terminal-api#cloud\\&quot;&gt;endpoint that is geographically closest&lt;\\\/a&gt; to your store location.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Connection Type&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-white_check_mark-\\&quot; alt=\\&quot;-white_check_mark-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/white_check_mark.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;Set to &lt;strong&gt;Cloud&lt;\\\/strong&gt;.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Sale ID&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-white_check_mark-\\&quot; alt=\\&quot;-white_check_mark-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/white_check_mark.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The unique ID that will be used in your API requests for your POS, for example &lt;strong&gt;Register1&lt;\\\/strong&gt;.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;POI ID&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-white_check_mark-\\&quot; alt=\\&quot;-white_check_mark-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/white_check_mark.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The unique ID of your Adyen terminal that you can find in 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;. Go to &lt;strong&gt;In-person payments&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Terminals&lt;\\\/strong&gt; and select your terminal.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;API Key&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-white_check_mark-\\&quot; alt=\\&quot;-white_check_mark-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/white_check_mark.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The API key you generated in 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; in &lt;a href=\\&quot;#configure-adyen\\&quot;&gt;Step 1&lt;\\\/a&gt;.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Transaction TimeOut&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-x-\\&quot; alt=\\&quot;-x-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/x.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The transaction timeout duration in seconds. The default value for the transaction timeout is &lt;strong&gt;120&lt;\\\/strong&gt; seconds.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Request\\\/Response TimeOut&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-x-\\&quot; alt=\\&quot;-x-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/x.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The internal timeout duration for the terminal. The default value for the request\\\/response timeout is &lt;strong&gt;3&lt;\\\/strong&gt; seconds.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Nbr Customer Payment Receipts&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-x-\\&quot; alt=\\&quot;-x-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/x.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The number of customer payment receipts printed by the printer. This value should be left as default (&lt;strong&gt;0&lt;\\\/strong&gt;) if the terminal prints the receipts.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Nbr Merchant Payment Receipts&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-x-\\&quot; alt=\\&quot;-x-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/x.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The number of merchant payment receipts printed by the printer. This value should be left as default (&lt;strong&gt;0&lt;\\\/strong&gt;) if the terminal prints the receipts.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Default Currency&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-x-\\&quot; alt=\\&quot;-x-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/x.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The default payment currency for your store.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Enable End Of Day&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-x-\\&quot; alt=\\&quot;-x-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/x.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;When selected, the plugin will prompt the cashier to print an end of day total when closing a sales day.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Prompt For Signature&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-x-\\&quot; alt=\\&quot;-x-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/x.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;When selected, the plugin will prompt the cashier to validate the signature of the shopper.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Legacy Mode&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-x-\\&quot; alt=\\&quot;-x-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/x.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;Deselected by default, Do not enable unless instructed by your Cegid contact.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td&gt;&lt;strong&gt;Ignore Void&lt;\\\/strong&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: center;\\&quot;&gt;&lt;img title=\\&quot;-x-\\&quot; alt=\\&quot;-x-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/x.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td&gt;The default behavior of the plugin for Void requests. It is recommended to set this value to &lt;strong&gt;Confirm Void&lt;\\\/strong&gt;. This will prompt the cashier to explicitly confirm or reject void by typing &lt;strong&gt;Yes&lt;\\\/strong&gt; or &lt;strong&gt;No&lt;\\\/strong&gt; in a text field.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/tbody&gt;\\n&lt;\\\/table&gt;\\n&quot;,&quot;altTitle&quot;:&quot;cloud&quot;,&quot;oldTabId&quot;:&quot;cloud_2&quot;,&quot;relation&quot;:&quot;&quot;}]\"\n            :should-update-when-url-changes='true'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n<\/li>\n<li>\n<p>Save your changes.<\/p>\n<\/li>\n<\/ol>\n<h2>Step 5: Configure cash register settings<\/h2>\n<p>To configure the settings for your cash register:<\/p>\n<ol>\n<li>Log in to your Cegid Retail Y2 back office.<\/li>\n<li>Go to <strong>Register settings<\/strong> &gt; <strong>Peripherals<\/strong>.<\/li>\n<li>Under <strong>Electronic Payment Terminal<\/strong>, select <strong>Authorization request on entry<\/strong> to automatically trigger payment requests for cash register entries. If you want to manually make payment requests, leave this box unchecked.<\/li>\n<li>Select <strong>Authorization while modifying payment<\/strong>, and <strong>Allocation of transaction number<\/strong>.<\/li>\n<li>Save your changes.<\/li>\n<li>Go to <strong>Register settings<\/strong> &gt; <strong>Preferences<\/strong>.<\/li>\n<li>In the list of <strong>Authorized methods of payment<\/strong>, select all payment methods you want to use.<\/li>\n<\/ol>\n<h2 id=\"add-pms\">Step 6: Set up payment methods<\/h2>\n<p>Adyen payment terminals return <a href=\"\/pt\/development-resources\/paymentmethodvariant\/\">\n  <code>paymentMethodVariant<\/code>\n<\/a> values that need to be translated into values that Cegid Retail Y2 can use. There are two ways to set up payment methods:<\/p>\n<ul>\n<li>Create a default payment method for Adyen and use a mapping table to map the values to different payment methods.<\/li>\n<li>Create multiple payment methods for different types of payment methods, or currencies. For example:\n<ul>\n<li>Create a payment method for <a href=\"\/pt\/point-of-sale\/what-we-support\/payment-methods#qr-code-wallets\">QR code wallets<\/a>, and use the mapping table to specify the values for each QR code wallet payment method.<\/li>\n<li>Create a payment method for the US Dollar currency, and use the mapping table to specify what type of cards can be used to pay with this currency.<\/li>\n<\/ul><\/li>\n<\/ul>\n<p>To set up payment methods, you have to:<\/p>\n<ol>\n<li><a href=\"#create-new-pm\">Create a new payment method, or multiple payment methods<\/a> for Adyen in Cegid Retail Y2 to trigger the plugin when doing a payment.<\/li>\n<li><a href=\"#create-map\">Create a mapping table<\/a> to link the payment method codes used by the Adyen terminal and the plugin.<\/li>\n<\/ol>\n<h3 id=\"create-new-pm\">Create a new payment method<\/h3>\n<ol>\n<li>Log in to your Cegid Retail Y2 back office.<\/li>\n<li>Go to <strong>Management<\/strong> &gt; <strong>Payment methods<\/strong>. This shows the payment methods available for your store.<\/li>\n<li>Create a new payment method. A pop-up window will appear.<\/li>\n<li>On the <strong>Characteristics<\/strong> tab:\n<ol>\n<li>Choose a <strong>Code<\/strong>, for example <strong>ADY<\/strong>.<\/li>\n<li>Choose a <strong>Short name<\/strong>, for example <strong>Adyen<\/strong>.<\/li>\n<li>For <strong>Category<\/strong> select <strong>Bank cards<\/strong>.<\/li>\n<li>For <strong>Direction<\/strong> select <strong>Mixed<\/strong>. This allows to offer refunds to your shoppers.<\/li>\n<\/ol><\/li>\n<li>On the <strong>Additions<\/strong> tab:\n<ol>\n<li>Select <strong>Card no<\/strong>, <strong>Expiry date<\/strong>, <strong>Type of card<\/strong>, <strong>Control number<\/strong>, <strong>Cardholder name<\/strong>, <strong>CVV \/ CV2\/ CID<\/strong>, and <strong>Transaction no<\/strong>.<\/li>\n<li>Select <strong>Authorisation number<\/strong>.<\/li>\n<li>Select <strong>Send amount to EPT<\/strong>.<\/li>\n<\/ol><\/li>\n<li>On the <strong>Front-Office<\/strong> tab, select the <strong>Usable in register<\/strong> checkbox and set <strong>Type<\/strong> to <strong>Bank card<\/strong>.<\/li>\n<li>Save your changes.<\/li>\n<\/ol>\n<h3 id=\"create-map\">Create a mapping table<\/h3>\n<ol>\n<li>Go to <strong>Register settings<\/strong> &gt; <strong>Peripheral settings<\/strong> &gt; <strong>EPT<\/strong>.<\/li>\n<li>Find the <strong>Mapping table<\/strong> and select the <strong>Edit<\/strong> icon next to it.<\/li>\n<li>Create a mapping table and name it, for example <strong>Adyen<\/strong>.<\/li>\n<li>On your mapping table, create entries to link the payment methods with the <a href=\"\/pt\/development-resources\/paymentmethodvariant\"><code>paymentMethodVariant<\/code> values sent by Adyen terminals<\/a>.<\/li>\n<li>Save your mapping table.<\/li>\n<li>Activate your mapping by selecting the table you created next to <strong>Mapping table<\/strong>.<\/li>\n<\/ol>\n<h2 id=\"refunds\">Step 7: Configure refund settings<\/h2>\n<p>You can offer two types of refunds to your shoppers:<\/p>\n<ul>\n<li><strong>Refund without control<\/strong>: refund any amount to any card presented to the payment terminal. Adyen refers to this kind of refunds as <a href=\"\/pt\/point-of-sale\/basic-tapi-integration\/refund-payment\/unreferenced\">unreferenced refunds<\/a>.<\/li>\n<li><strong>Refund with control<\/strong>: refund the partial or full amount connected to an original payment, using the unique identifier of that payment. Adyen refers to this kind of refunds as <a href=\"\/pt\/point-of-sale\/basic-tapi-integration\/refund-payment\/referenced\">referenced refunds<\/a>.<\/li>\n<\/ul>\n<p>The <strong>Payment configuration<\/strong> you set when you <a href=\"#configure-cegid\">set up the plugin in Cegid Retail Y2<\/a> specifies the default type of refunds the configured payment method will execute.<\/p>\n<p>To offer referenced refunds, there are additional settings to configure:<\/p>\n<ol>\n<li>Log in to your Cegid Retail Y2 back office.<\/li>\n<li>Go to <strong>Register settings<\/strong> &gt; <strong>Management<\/strong>.<\/li>\n<li>Select <strong>Check returns of merchandises<\/strong> and <strong>Checking reimbursement card<\/strong>.<\/li>\n<\/ol>\n<div class=\"notices green\">\n<p>Keep in mind that in some cases, the amount will be refunded by unreferenced refund regardless of your <strong>Payment configuration<\/strong>. For example, partial refunds, and refunds for payments completed with multiple payment methods, the refund type will be unreferenced.<\/p>\n<\/div>\n<p>For documentation on advanced use cases, refer to the documentation file in the installation folder.<\/p>\n<h2 id=\"configure-merchant-reference\">Step 8 (Optional): Configure merchant reference<\/h2>\n<p>You can configure a merchant reference to customize the value that shows up in the Adyen <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a> under <strong>Transactions<\/strong> &gt; <strong>Payments<\/strong> &gt; <strong>Merchant Reference<\/strong> and in <a href=\"\/pt\/reporting\/settlement-reconciliation\/transaction-level\/settlement-details-report\">settlement details reports<\/a>.<\/p>\n<div class=\"notices yellow\">\n<p>You need administrator rights to complete this configuration.<\/p>\n<\/div>\n<p>To configure a merchant reference:<\/p>\n<ol>\n<li>Log in to your Cegid Retail Y2 back office.<\/li>\n<li>Go to <strong>Register settings<\/strong> &gt; <strong>Peripherals<\/strong>.<\/li>\n<li>Under <strong>Electronic Payment Terminal<\/strong>, set a <strong>Transaction number prefix<\/strong> and a <strong>Number length<\/strong>.<\/li>\n<li>Save your changes.<\/li>\n<\/ol>\n<p>After you configured a merchant reference, your transactions are registered to Cegid Retail Y2 and Adyen according to the values you set. For example, if you set <strong>1234<\/strong> for the <strong>Transaction number prefix<\/strong> and <strong>10<\/strong> for the <strong>Number length<\/strong>, your first transaction will have <code>[SALEID]1234000001<\/code> as merchant reference.<\/p>\n<p>Make sure that the <strong>Number length<\/strong> you set is higher than the amount of characters you have in the <strong>Transaction number prefix<\/strong>. If your prefix is longer than the length, for example, if you set <strong>12345<\/strong> for the <strong>Transaction number prefix<\/strong>, and <strong>4<\/strong> for the <strong>Number length<\/strong>, CPOS uses the date and time instead.<\/p>\n<h2 id=\"test-and-go-live\">Test and go live<\/h2>\n<h3 id=\"test-integration\">Test your integration<\/h3>\n<p>Check if the plugin is communicating correctly with the terminal:<\/p>\n<ol>\n<li>In the Cegid Retail Y2 back office, go to <strong>Settings<\/strong> &gt; <strong>Registers<\/strong> and select your register.<\/li>\n<li>Select  <strong>Settings for Peripheral<\/strong>  and then select <strong>EPT<\/strong>.<\/li>\n<li>On the <strong>Management Tab<\/strong> select <strong>Device test<\/strong>.<\/li>\n<li>Verify that the pop-up window shows <strong>Test successful<\/strong>. This means that your plugin has been configured correctly.<\/li>\n<\/ol>\n<p>After you have verified your plugin is configured correctly, perform a test transaction:<\/p>\n<ol>\n<li>Log in to your Cegid Retail Y2 back office.<\/li>\n<li>Go to <strong>Sales receipts<\/strong> &gt; <strong>Enter transaction<\/strong>.<\/li>\n<li>Choose an item and give it a price.<\/li>\n<li>Select <strong>ADYEN CREDIT CARDS<\/strong> and then select the <i class=\"adl-icon-checkmark-small\"><\/i> icon.<\/li>\n<li>Pay with your Adyen terminal using your Adyen test card.<\/li>\n<li>In Cegid Retail Y2, check if there is a receipt for the test transaction.<\/li>\n<\/ol>\n<h3 id=\"go-live\">Go live<\/h3>\n<p>There are steps you have to complete after testing your integration before you can start accepting real payments:<\/p>\n<ol>\n<li>Order new payment terminals from the live <a href=\"https:\/\/ca-live.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>.<\/li>\n<li>Repeat <a href=\"#configure-adyen\">Step 1: Configure your Adyen account<\/a> in your live <a href=\"https:\/\/ca-live.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>.<\/li>\n<li><a href=\"#test-integration\">Test your integration<\/a> to make sure the plugin has been configured correctly.<\/li>\n<\/ol>\n<h2>Upgrade the plugin<\/h2>\n<p>When a new version of the plugin is released, you can find it in our <a href=\"\/pt\/plugins\/release-notes\">release notes<\/a>. When there is a new version, we update our documentation with the new installation file.<\/p>\n<p>To upgrade your plugin, follow the steps the <a href=\"#download-and-install-the-plugin\">download and install the plugin<\/a>. You do not need to follow the other steps on this page again.<\/p>","url":"https:\/\/docs.adyen.com\/pt\/plugins\/cegid-retail-y2\/set-up-the-plugin","articleFields":{"description":"Learn how to set up, test, and go live with our Cegid Retail Y2 CPOS plugin.","feedback_component":true,"next_steps":[{"title":"Set up gift cards","description":"Set up gift card payments for your CPOS integration.","url":"\/plugins\/cegid-retail-y2\/giftcards","required":false},{"title":"Mobile POS and Live Store","description":"Learn more about using Tap to Pay on iPhone and Pay by Link using Cegid Retail Mobile POS and Live Store.","url":"\/plugins\/cegid-retail-y2\/mobile-pos-and-live-store","required":false}],"last_edit_on":"19-12-2024 14:37","filters_component":false,"page_id":"b285891e-6d75-4bb8-acdb-48b7ddd4d02f","decision_tree":"[]"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/plugins\/cegid-retail-y2\/set-up-the-plugin","title":"Set up the plugin","content":"Follow the steps below to set up the CPOS plugin in your Adyen Customer Area and the Cegid Retail Y2 back office. After you have completed the setup steps, test your integration to make sure the plugin works correctly.\nAfter you are done testing, follow the steps to go live with your integration.\nStep 1: Download and install the plugin\nDownload the plugin:\n\nContact our Support Team to receive the password for the plugin installation file.\nOnly if you have already integrated with the plugin and are downloading to upgrade to a later version:\na. Uninstall older versions of the plugin.\nb. Reboot the device that Cegid Retail Y2 is installed on.\nDownload and unzip the password protected Cegid Retail Y2 CPOS plugin installation file for v2.1.26.\n\nInstall the plugin:\n\nRun the Setup_Retailstars.CAT.ADYEN.MULTI_2.1.*.exe file.\nWhen prompted to select a setup language, select English and then select OK.\nThe installation path defaults to C:\\Program Files (x86)\\Retailstars\\CPOS, in the Folder Exists pop-up window, select Yes.\nDouble-check that the Destination location is set to the correct installation path. You can only change the installation directory of CPOS by uninstalling and reinstalling after installation is complete.\nSelect Install.\nWhen the installation is complete, select Finish.\n\nCheck if the plugin is connected to Cegid Retail Y2 correctly:\n\nIn the Cegid Retail Y2 back office, go to Settings &gt; Registers and select your register.\nSelect Settings for Peripheral and then select EPT.\n\nCheck if the following values are set correctly:\n\nDLL name: Retailstars.CAT.CPOS.ADYEN.MULTI\nDriver name: ADYEN.MULTI\n\nIf required, manually set the correct values.\n\nIf you want to process payments with gift cards, set the Identifier to 1.\n\nStep 2: Configure your Adyen account\nFor this task, you must have the following user role:\n\nMerchant POS Terminal Management Admin role\n\n\n\n    \n        \n        \n    \n\n\nStep 3: Get your Adyen payment terminals\nThe plugin can only communicate with terminals that are injected with Adyen software. To obtain these terminals:\n\nCreate store IDs for the stores where you want the plugin to accept payments.\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 4: Set up the plugin in Cegid Retail Y2\nTo configure the CPOS plugin in the Cegid Retail Y2 back office:\n\n\nIn the Cegid Retail Y2 back office, go to Settings &gt; Registers and select your register.\n\n\nSelect Settings for Peripheral and select EPT.\n\n\nSelect Settings for Peripheral and fill these properties:\n\n\n    \n        \n        \n    \n\n\n\n\nSave your changes.\n\n\nStep 5: Configure cash register settings\nTo configure the settings for your cash register:\n\nLog in to your Cegid Retail Y2 back office.\nGo to Register settings &gt; Peripherals.\nUnder Electronic Payment Terminal, select Authorization request on entry to automatically trigger payment requests for cash register entries. If you want to manually make payment requests, leave this box unchecked.\nSelect Authorization while modifying payment, and Allocation of transaction number.\nSave your changes.\nGo to Register settings &gt; Preferences.\nIn the list of Authorized methods of payment, select all payment methods you want to use.\n\nStep 6: Set up payment methods\nAdyen payment terminals return \n  paymentMethodVariant\n values that need to be translated into values that Cegid Retail Y2 can use. There are two ways to set up payment methods:\n\nCreate a default payment method for Adyen and use a mapping table to map the values to different payment methods.\nCreate multiple payment methods for different types of payment methods, or currencies. For example:\n\nCreate a payment method for QR code wallets, and use the mapping table to specify the values for each QR code wallet payment method.\nCreate a payment method for the US Dollar currency, and use the mapping table to specify what type of cards can be used to pay with this currency.\n\n\nTo set up payment methods, you have to:\n\nCreate a new payment method, or multiple payment methods for Adyen in Cegid Retail Y2 to trigger the plugin when doing a payment.\nCreate a mapping table to link the payment method codes used by the Adyen terminal and the plugin.\n\nCreate a new payment method\n\nLog in to your Cegid Retail Y2 back office.\nGo to Management &gt; Payment methods. This shows the payment methods available for your store.\nCreate a new payment method. A pop-up window will appear.\nOn the Characteristics tab:\n\nChoose a Code, for example ADY.\nChoose a Short name, for example Adyen.\nFor Category select Bank cards.\nFor Direction select Mixed. This allows to offer refunds to your shoppers.\n\nOn the Additions tab:\n\nSelect Card no, Expiry date, Type of card, Control number, Cardholder name, CVV \/ CV2\/ CID, and Transaction no.\nSelect Authorisation number.\nSelect Send amount to EPT.\n\nOn the Front-Office tab, select the Usable in register checkbox and set Type to Bank card.\nSave your changes.\n\nCreate a mapping table\n\nGo to Register settings &gt; Peripheral settings &gt; EPT.\nFind the Mapping table and select the Edit icon next to it.\nCreate a mapping table and name it, for example Adyen.\nOn your mapping table, create entries to link the payment methods with the paymentMethodVariant values sent by Adyen terminals.\nSave your mapping table.\nActivate your mapping by selecting the table you created next to Mapping table.\n\nStep 7: Configure refund settings\nYou can offer two types of refunds to your shoppers:\n\nRefund without control: refund any amount to any card presented to the payment terminal. Adyen refers to this kind of refunds as unreferenced refunds.\nRefund with control: refund the partial or full amount connected to an original payment, using the unique identifier of that payment. Adyen refers to this kind of refunds as referenced refunds.\n\nThe Payment configuration you set when you set up the plugin in Cegid Retail Y2 specifies the default type of refunds the configured payment method will execute.\nTo offer referenced refunds, there are additional settings to configure:\n\nLog in to your Cegid Retail Y2 back office.\nGo to Register settings &gt; Management.\nSelect Check returns of merchandises and Checking reimbursement card.\n\n\nKeep in mind that in some cases, the amount will be refunded by unreferenced refund regardless of your Payment configuration. For example, partial refunds, and refunds for payments completed with multiple payment methods, the refund type will be unreferenced.\n\nFor documentation on advanced use cases, refer to the documentation file in the installation folder.\nStep 8 (Optional): Configure merchant reference\nYou can configure a merchant reference to customize the value that shows up in the Adyen Customer Area under Transactions &gt; Payments &gt; Merchant Reference and in settlement details reports.\n\nYou need administrator rights to complete this configuration.\n\nTo configure a merchant reference:\n\nLog in to your Cegid Retail Y2 back office.\nGo to Register settings &gt; Peripherals.\nUnder Electronic Payment Terminal, set a Transaction number prefix and a Number length.\nSave your changes.\n\nAfter you configured a merchant reference, your transactions are registered to Cegid Retail Y2 and Adyen according to the values you set. For example, if you set 1234 for the Transaction number prefix and 10 for the Number length, your first transaction will have [SALEID]1234000001 as merchant reference.\nMake sure that the Number length you set is higher than the amount of characters you have in the Transaction number prefix. If your prefix is longer than the length, for example, if you set 12345 for the Transaction number prefix, and 4 for the Number length, CPOS uses the date and time instead.\nTest and go live\nTest your integration\nCheck if the plugin is communicating correctly with the terminal:\n\nIn the Cegid Retail Y2 back office, go to Settings &gt; Registers and select your register.\nSelect  Settings for Peripheral  and then select EPT.\nOn the Management Tab select Device test.\nVerify that the pop-up window shows Test successful. This means that your plugin has been configured correctly.\n\nAfter you have verified your plugin is configured correctly, perform a test transaction:\n\nLog in to your Cegid Retail Y2 back office.\nGo to Sales receipts &gt; Enter transaction.\nChoose an item and give it a price.\nSelect ADYEN CREDIT CARDS and then select the  icon.\nPay with your Adyen terminal using your Adyen test card.\nIn Cegid Retail Y2, check if there is a receipt for the test transaction.\n\nGo live\nThere are steps you have to complete after testing your integration before you can start accepting real payments:\n\nOrder new payment terminals from the live Customer Area.\nRepeat Step 1: Configure your Adyen account in your live Customer Area.\nTest your integration to make sure the plugin has been configured correctly.\n\nUpgrade the plugin\nWhen a new version of the plugin is released, you can find it in our release notes. When there is a new version, we update our documentation with the new installation file.\nTo upgrade your plugin, follow the steps the download and install the plugin. You do not need to follow the other steps on this page again.","type":"page","locale":"pt","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Plugins","lvl2":"Cegid Retail Y2","lvl3":"Set up the plugin"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/plugins","lvl2":"https:\/\/docs.adyen.com\/pt\/plugins\/cegid-retail-y2","lvl3":"\/pt\/plugins\/cegid-retail-y2\/set-up-the-plugin"},"levels":4,"category":"Plugins","category_color":"green","tags":["plugin"]},"articleFiles":{"Cegid-Plugin-v2.1.26.zip":"<p alt=\"\">Cegid-Plugin-v2.1.26.zip<\/p>"}}
