--- schema_version: "1" id: 2de35636b419cdb0a3ff094cb3cccc159dfe4017bf4d9b71a10f5123b778bea7 title: Ayden Payment Resources collection: admin version: current locale: en-us portal_url: https://docs.salesforce.com/admin/current/en-us/commerce/264-0-0/rt_cms_hardware_ayden_payment_resources.md canonical_url: https://help.salesforce.com/s/articleView?id=commerce.rt_cms_hardware_ayden_payment_resources.htm&release=264.0.0&type=5 source_site: help.salesforce.com content_type: documentation content_hash: b4bd308e7a258e72ea4209f44d629bf2ef1adade5facfbb6ad168bb59f5ee239 description: Integrate Adyen payment resources with Point of Sale CMS to process point-of-sale transactions. Use either Adyen SDK or Terminal API configurations for terminals. products: - Commerce release: "264" --- # Ayden Payment Resources Integrate Adyen payment resources with Point of Sale CMS to process point-of-sale transactions. Use either Adyen SDK or Terminal API configurations for terminals. The Adyen SDK is used for legacy terminals like e315. All the new terminals that aren't connected via the iPad Lightning port use the terminal API. ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-commerce-retail-264-0-0-production-enus/17d647fb-8988-49fb-9add-c4f4cc79c9e4/images/icon_note.png) Note As of 2022, Adyen doesn’t support the e315 device. ## Prerequisites - If you've yet to set up an Adyen and Point of Sale account, make sure your StoreIDs are the same for both accounts. - If your Point of Sale account is live but you haven’t set up Adyen, make sure your Adyen StoreID is the same as your Point of Sale's StoreID. - If your Adyen account is live but you haven’t set up Point of Sale, make sure your Retail Cloud StoreID is the same as Adyen's StoreID. - To test contactless payments, use a card version of 2.4 or newer. ## Merchant Accoount Architecture Adyen has three levels of accounts: - A single company account on the Adyen platform. This represents your core business entity and is where invoices for terminal orders are sent. - One or more merchant accounts under your company account. You receive settlements and reports at the merchant account level. You can also group together merchant accounts into account groups. - One or more stores under each merchant account. These represent your physical store locations and are used to process point-of-sale transactions. Each Adyen terminal is associated with a store. Although payments are processed through terminals and stores, your transactions are settled at the merchant account level. ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-commerce-retail-264-0-0-production-enus/17d647fb-8988-49fb-9add-c4f4cc79c9e4/images/icon_note.png) Note Amex requires separate merchant IDs (MIDs) for ecommerce and Point of Sale (POS). Visa, Mastercard, and so on don't require separate MIDs. ## Configuring Registers with Adyen Terminal API Go to the Register of Interest and scroll down to the **Card Reader** section. Set Integration Type to **Local API (for Terminal API)** or **SDK** for using the Native iOS SDK. ## Register Configured to Use SDK To configure a register to use Adyen SDK, select **SDK** under the Integration Type. ![The Card Reader section of Point of Sale CMS, where you set the integration type](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-commerce-retail-264-0-0-production-enus/17d647fb-8988-49fb-9add-c4f4cc79c9e4/retail/images/rt_cms_hardware_ayden_sdk_card_reader.png) ## Register configured to Use Terminal API To configure a register to use Terminal API, select **Local API** under the Integration Type. ## Ayden Payment Resources - End-User Documentation Store managers can configure their Adyen terminals in use the Terminal API, allowing devices to work together with Point of Sale CMS and the Point of Sale (POS) app. ### Configure Terminal Device to Use Terminal API 1. Press **9** and then **O** on the Adyen Terminal to go to the admin menu. 2. Enter the admin password. To find the admin password from the Adyen portal: 1. Go to the [live site](https://ca-live.adyen.com/ca/ca/login.shtml) or [test site](https://ca-test.adyen.com/ca/ca/login.shtml) as required 2. Select **In-person payments > Terminals** 3. Select the terminal with **serial number > Advanced**. 4. Select **View Decrypted Properties** to see the admin menu pin in the Advanced section. 3. Select **Config > Update** in the Admin menu to sync the terminal device with all the changes made in the Adyen console. 4. After the update finishes, the terminal is ready to make transactions using Terminal API. The terminal will have a cloud icon on the top to confirm switching to Terminal API. ### Turn On Terminal API in the POS App ![Important](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-commerce-retail-264-0-0-production-enus/17d647fb-8988-49fb-9add-c4f4cc79c9e4/images/icon_important.png) Important Salesforce Customer Support can configure these settings. This step requires CMS access to turn on and assign values to the flags that control the use of Terminal API in the POS app. 1. Go to **Modules > Payments** in CMS and turn on the **Use Adyen Terminal API** flag. 2. Configure Payment Gateway with the right values by following this [article](https://help.salesforce.com/s/articleView?id=commerce.rt_adv_config_pay_gate_config.htm&release=264.0.0&type=5 "Configure payment gateways in Point of Sale CMS to securely process customer payments. By connecting preferred payment providers, you streamline transactions and enhance the customer checkout experience. Accept a variety of payment methods, reduce friction, and improve overall sales efficiency."). 3. Relaunch the POS app to get the updated CMS settings reflected in the app. ### Switching Adyen Terminal From Terminal API to Use iOS SDK ![Important](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-commerce-retail-264-0-0-production-enus/17d647fb-8988-49fb-9add-c4f4cc79c9e4/images/icon_important.png) Important Salesforce Customer Support can configure these settings. 1. Disable **Terminal API** in POS App. Adyen Terminal API has to be enabled in the CMS for the merchant to assign these values. 2. Turn off the **Use Adyen Terminal API** flag. 3. Relaunch the POS app to get the updated CMS settings reflected in the app. ### Disable Terminal API in Adyen Console ![Important](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-commerce-retail-264-0-0-production-enus/17d647fb-8988-49fb-9add-c4f4cc79c9e4/images/icon_important.png) Important Salesforce Customer Support can configure these settings. 1. Go to the Adyen Site, [live site.](https://ca-live.adyen.com/ca/ca/login.shtml) 2. If you're testing an Adyen device, go to the [Test Site](https://ca-test.adyen.com/ca/ca/overview/default.shtml). 3. Go to the In-person payments tab and select **Terminal settings > Integrations** on the website. 4. Disable **Enable terminal API**.![The Enable terminal API flag.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-commerce-retail-264-0-0-production-enus/17d647fb-8988-49fb-9add-c4f4cc79c9e4/retail/images/rt_cms_hardware_enable_terminal_api.png) ### Configure Adyen Terminal to Use iOS SDK ![Important](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-commerce-retail-264-0-0-production-enus/17d647fb-8988-49fb-9add-c4f4cc79c9e4/images/icon_important.png) Important Store managers with the admin password for the terminals can collectively configure all the store devices to use Adyen iOS SDK. 1. Go to **Configuration** in the Admin menu of Adyen Terminal by selecting **9** and **O**. 2. Select **update** to get the changes made in the website synced with the terminal. 3. After the update finishes, the terminal is switched back to using iOS Adyen SDK for transactions. Confirm by checking the removal of the cloud icon at the top of the home screen. 4. This step is only for V400M - Enable Print options for V400M: 1. Go to the **Receipt** option on the website. 2. Select **Delete this ConfigurationOption** under **Print receipt** on Terminal. 3. Select **Save** at the bottom of the screen. ### Set up Standalone Terminal The Adyen terminal can accept payments without being connected to the store associate app. To see the full details of standalone terminals, check out this [article](https://help.salesforce.com/s/articleView?id=commerce.rt_cms_hardware_configure_standalone_mode.htm&release=264.0.0&type=5 "Configure Adyen terminals to accept payments via Point of Sale without a store associate Point of Sale (POS) app connection during an outage."). ### Enabling Beacons Beacon functionality in Adyen Terminal allows it to broadcast its presence to nearby Bluetooth devices. We use beacons in the Adyen terminals to locate them from our POS app and connect them to the ‌one to carry out the particular transaction. To learn more, check out the [article](https://help.salesforce.com/s/articleView?id=commerce.rt_cms_hardware_ayden_enabling_beacons.htm&release=264.0.0&type=5 "Beacon functionality in Adyen Terminal allows it to broadcast its presence to nearby Bluetooth devices. We use beacons in the Adyen terminals to locate them from the Point of Sale Point of Sale (POS) app and connect them to the one to carry out the particular transaction.") on configuring beacons. ### Ayden Pairing Guide A new Adyen terminal has to fetch the configuration set up from the portal during the boarding process. You can check out the pairing guide documentation in this [article](https://help.salesforce.com/s/articleView?id=commerce.rt_cms_hardware_connect_ayden_and_pos.htm&release=264.0.0&type=5 "Set up Adyen terminals to connect to the Modern POS and process payments. Connect your Adyen terminal to Wi-Fi, board the device, and then pair it with the POS app."). ### Adyen Reassigning Terminals If for any reason you move a terminal to another store or merchant, you can do so in the Adyen console by assigning or reassigning Terminals to Stores under the same account. To see more details on reassigning terminals, check out this [article](https://help.salesforce.com/s/articleView?id=commerce.rt_cms_hardware_assign_ayden_different_acct.htm&release=264.0.0&type=5 "Reassign an Adyen terminal so that transactions are processed under the correct merchant account in Point of Sale."). ### Adyen Payment Methods To see more details on supported payment methods, refer to this [article](https://help.salesforce.com/s/articleView?id=commerce.rt_cms_hardware_adyen_payment_methods.htm&release=264.0.0&type=5 "Integrate supported Adyen payment methods integrate with Point of Sale (POS), allowing your customers to use a variety of payment options."). ### Point of Sale CMS Configuration To learn how to configure Adyen as a payment gateway integration in CMS, refer to this [article](https://help.salesforce.com/s/articleView?id=commerce.rt_adv_config_pay_gate_config.htm&release=264.0.0&type=5 "Configure payment gateways in Point of Sale CMS to securely process customer payments. By connecting preferred payment providers, you streamline transactions and enhance the customer checkout experience. Accept a variety of payment methods, reduce friction, and improve overall sales efficiency."). ### Troubleshooting To find more Adyen troubleshooting information, check out this [article](https://help.salesforce.com/s/articleView?id=commerce.rt_cms_hardware_ttp_troubleshooting.htm&release=264.0.0&type=5 "Resolve Tap to Pay errors and connection problems by verifying your Adyen configuration in the Point of Sale (POS) app and internet connection.").