Configure features

Configure your account and terminals for the features you want to use.

View source

The Adyen payment terminals support many features beyond the basic transactions of making, refunding, and canceling payments. Some advanced features require additional configuration steps. You can do this in your Customer Area or using API calls. In some cases you need to contact our Support Team to complete the configuration.

If you are looking for settings that moved or were renamed in the Customer Area, see Customer Area UI change mapping.

Here we explain the effect of configuring features at different levels, and where you can find feature settings in your Customer Area.

Requirements

Before you begin, take into account the following requirements.

Requirement	Description
Integration type	A Terminal API integration or Standalone solution using Adyen payment terminals.
Customer Area roles	Make sure that you have the following roles: To view terminal features: Merchant POS standard role or Merchant POS Terminal View role. To view and configure terminal features: Merchant POS Terminal Management Admin role.

Inheritance of settings

You can define terminal settings at different levels. From high to low:

Company account level
Merchant account level
Store level
Terminal level

The top level, above the company level, is the Adyen level. This is known as the PSP level. You cannot define settings at PSP level.

Settings at the company level apply to all terminals under the company. Settings at the merchant account level override settings inherited from the company level and apply to all terminals under the merchant account, and so on.

In other words: settings defined at a certain level propagate to all terminals at and under that level. But settings defined at a lower level replace values inherited from a higher level.

To manage your terminals effectively, we recommend setting configurations at the merchant account level.

In your Customer Area:

Settings marked
Adyen default
are configured by Adyen. If you hover over the tag, you will see Inherited from AdyenPspService.
If a setting is inherited from a higher level, that level is mentioned. For example:
Company default
The navigation path at the top of the page shows the inheritance hierarchy. You can select a level in the navigation path to go to its settings page.
If a setting is enabled or disabled at a higher level, the toggle is grey. For example:

Toggle Description

Inherited setting, enabled at a higher level.

Enabled at the current level.

Disabled at the current level.

When new settings take effect

After you changed the settings for a feature, the changes take effect when a payment terminal updates its configuration during the next reboot hour. To use the new settings immediately, you can update the configuration manually.

Payment methods

The Adyen payment terminals accept global credit cards and Maestro out-of-the-box. If you also want to accept local credit or debit cards, wallets, or gift cards, you need to add these payment methods to your account.

In your Customer Area, you can find payment methods under Settings > Payment methods.

For an overview of supported payment methods and instructions, see:

Find and edit settings

To access Device settings:

Log in to your Customer Area.
Switch to your merchant account.
Go to Devices > Device settings. Or to define settings at the level of an individual terminal, go to Devices > Device list, select the Terminals tab, and then select your terminal.

The settings are organized into categories. You can find them under Device , Device connectivity , Payment features , and Integrations . Settings that are only available at the terminal level are noted in the description.

Device category

You can use these settings to configure the terminal's regional, display, sound, and hardware preferences.

Feature	Settings and descriptions
Location & language	Location: The terminal's country or region. Timezone: The terminal's timezone. Language: The default language on the terminal display and receipts. When the shopper presents their card, the terminal switches to the language of the country/region where the card was issued. Secondary language: A secondary language that the shopper can select during payment. Amount format: The decimal format for amounts shown on receipts and the Totals report.
Device name	The logical name used by the POS library to address the terminal and displayed in the Customer Area.
Sound	Normal sound volume: The volume for regular terminal sounds. Error sound volume: The volume for error alert sounds. Contactless sound volume: The volume for contactless payment sounds. On Android terminals, the normal sound volume also applies to the other sound types. Enable keyboard beep: Whether the terminal beeps when the keypad is used.
Theme	The theme for your terminals. To customize or create a new theme, see Theme customization.
Home screen	Settings menu: Whether the Settings menu shortcut is shown on the home screen. Transactions menu: Whether the Transactions menu shortcut is shown on the home screen. On-screen notifications: Whether on-screen notifications are enabled on the terminal. Display name: The name that identifies the terminal on the home screen.
Kiosk mode	Hide navigation bar: Whether the navigation bar at the bottom of Android terminal screens is hidden from shoppers. Apps allowed in kiosk mode: The apps that can be accessed while the terminal is in kiosk mode. Default start app: The app that opens automatically when the terminal starts.
Maintenance	Restart hour: The hour at which the terminal receives important updates, such as software updates. Reset totals hour: The hour at which the terminal resets its totals and generates the daily Totals report. Maintenance interval: How often the terminal checks for configuration changes.
Passcodes	Passcodes to protect access to the Transactions menu, Settings menu, refunds, and screen lock on the terminal.
Logos	Upload your company logo to use as the terminal standby screen. Each setting represents a terminal model for which you can upload a logo file.
Barcode scanner	Barcode scanner settings for supported terminal models.

Device connectivity category

You can use these settings to configure how the terminal connects to your network. When connecting the terminal to your network, follow the instructions in the user guide for your terminal model.

Feature	Settings and descriptions
Wi-Fi profiles	Saved Wi-Fi profiles for your terminals. Most terminal models support Wi-Fi. Setting up Wi-Fi profiles is recommended. See Set up remote Wi-Fi profiles.
Wi-Fi	Wi-Fi connection details for the terminal. These settings are only available at the terminal level.
Ethernet	Ethernet connection details for the terminal. These settings are only available at the terminal level.
Cellular	Cellular connection details for the terminal. These settings are only available at the terminal level. To enable 3G/4G, contact our Support Team.
Bluetooth	Bluetooth connection details for the terminal. See Bluetooth PAN and tethering.
USB	The USB mode for the terminal. Options are Ethernet RNDIS and Ethernet ECM.
Beacons	Bluetooth beacons that let your mobile POS app connect to the nearest terminal.
TLS	Enable whitelisting: Whether to restrict the terminal's outbound connections to Adyen-approved endpoints only. HTTP content encoding: Whether to enable HTTP content encoding for terminal-to-platform communication. HTTP persistent connections: Whether to keep HTTP connections open between requests. TLS min version: The minimum TLS version required for secure communication.
Base station	The base station connection for the V400m terminal. Follow the V400m user guide to connect to the base station. This setting is only available at the terminal level.

Payment features category

In a Terminal API integration the availability of features depends on whether your POS app is compatible with the feature.

You can use these settings to enable and configure the payment features available on your terminals.

Feature	Settings and descriptions
Card application selection	Application selection rules for co-badged and combo cards. To customize these rules, contact our Support Team or your Adyen account manager.
Tipping	A gratuity added to the bill by the shopper. For tipping from the terminal, you may need to contact our Support Team and/or define tipping options.
Transaction limits	Max. amount: The maximum transaction amount the terminal accepts, in the processing currency. Min. amount: The minimum transaction amount the terminal accepts, in the processing currency.
Manual key entry (MKE)	Manual entry of card details when other methods fail and the shopper is present. You can set a maximum transaction amount. To enable MKE, contact our Support Team, then set a maximum limit.
Refunds	Unreferenced refunds: Refunds to any card presented at the point of sale, without connecting the refund to the original payment. See Enable unreferenced refunds. Offline refund: Refunds while your integration is offline. Includes a maximum offline refund amount. To enable offline refunds, contact our Support Team, then set a limit.
Offline processing	Chip floor limit: The maximum offline transaction amount for chip cards, in the processing currency. Offline swipe limit: The maximum offline transaction amount for swiped cards, in the specified currency. Contactless floor limit: The transaction limit above which contactless transactions must be authorized online. We recommend keeping the default limit of 0. To enable offline processing and set limits, contact our Support Team.
Store-and-forward	The maximum amount for store-and-forward transactions, and the maximum number of store-and-forward transactions the terminal accepts while it is offline. To enable store-and-forward, contact our Support Team.
Contactless cards	Contactless reader limit: The transaction amount above which the contactless reader does not work and the cardholder needs to insert the card. We recommend leaving this at the default to allow mobile phone and smart watch payments. Contactless CVM limit: The transaction limit above which contactless transactions require cardholder verification.
Mail order/Telephone order (MOTO)	Card-not-present transactions from the terminal, with or without Address Verification System (AVS) check. Includes a maximum transaction amount. To enable MOTO and AVS, contact our Support Team, then set a limit.
Receipts	The transaction outcomes for which a merchant and/or shopper receipt is printed. Includes language exclusions, ask-before-printing option, receipt image, QR code, and custom header lines.
Smart pre-authorization	A feature that checks if the card presented by the shopper is of a brand that supports authorization adjustment.
CVM signature	Whether the shopper signs on the terminal display or on the receipt when the terminal prompts for a signature.
Accessible audio support	Accessible audio support on the terminal for shoppers with visual impairments.

Integrations category

You can use these settings to configure integrations for your terminals.

Feature	Settings and descriptions
OPI	The OPI (Open Payment Initiative) integration for supported POS middleware. Includes tipping and event URL configuration. To enable OPI, contact our Support Team.
Standalone	Only required for the Standalone solution. For example, in combination with enabling offline payments, as a fallback when the network connection fails. Only terminals with a built-in printer can be used as standalone terminals. See Set up standalone terminals.
Wallet passes and keys	NFC wallet passes and keys for your terminals.
Terminal API	Enable Terminal API: Required for Terminal API integrations, both cloud and local architectures. Enable WebSockets: Required for Terminal API with a cloud architecture. `AdditionalResponse` format: The format of the `AdditionalResponse` field — Base64-encoded JSON or key-value pairs.

Customer Area UI change mapping

The Customer Area was updated with a new Device settings structure. Terminal settings is now called Device settings. Some settings were moved or renamed, and some were removed. Use the tables below to find where settings moved to and which settings are no longer available.

Moved and renamed settings

The following settings have been renamed or moved to a new location as part of the Device settings restructure.

Device

Setting	Old path	New path	Change notes
Location	Customization > Location	Device > Location & language	Category previously called Location. Setting previously called Country/Region.
Timezone	Customization > Location	Device > Location & language
Language	Customization > Location	Device > Location & language
Secondary language	Customization > Location	Device > Location & language
Amount format	Customization > Location	Device > Location & language
Device name	Customization > Signature and device name	Device > Device name
Sound settings	Customization > Volume	Device > Sound	Category previously called Volume. Setting previously called Sound settings.
Theme	Customization	Device > Theme
Logo	Customization	Device > Logos	Previously called Logo.
Transactions menu	Customization	Device > Home screen
Display name	Customization > Signature and device name	Device > Home screen	Previously called Device slogan.
Passcodes	Terminal passcodes / Screen lock passcode	Device > Passcodes	Merged from two categories: Terminal passcodes and Screen lock passcode.
Connectivity	Connectivity	Device connectivity

Payment features

Setting	Old path	New path	Change notes
Transaction limits	Transaction & MKE Limits	Payment features > Transaction limits	Category previously called Transaction & MKE Limits. MKE max. amount moved to the new Manual Key Entry (MKE) category.
Manual Key Entry (MKE)	Transaction & MKE Limits	Payment features > Manual Key Entry (MKE)	New category. MKE max. amount was previously in Transaction & MKE Limits.
Refunds	Refund	Payment features > Refunds	Category previously called Refund.
Offline processing	General	Payment features > Offline processing	Terminal type moved here from General.
Store-and-forward	Store-and-forward payments	Payment features > Store-and-forward	Category previously called Store-and-forward payments.
Contactless cards	Limits	Payment features > Contactless cards	Category previously called Limits.
Card application selection	Selection rules	Payment features > Card application selection	Category previously called Selection rules.
Receipts	General	Payment features > Receipts	Print receipts for previously called Print receipts.
Excluded languages	Customization > Location	Payment features > Receipts
Enable smart pre-authorization	Filter supported Brands	Payment features > Smart pre-authorization	Previously called Filter supported Brands.
Excluded funding sources	Filter Funding Source	Payment features > Smart pre-authorization	Previously called Filter Funding Source.
CVM signature	Customization > Signature and device name	Payment features > CVM signature	Category previously called Signature and device name. Ask for signature on screen instead of receipt previously called Ask for signature.

Integrations

Setting	Old path	New path	Change notes
Wallet passes and keys	Integrations > NFC wallet passes	Integrations > Wallet passes and keys	Category previously called NFC wallet passes.
Pay@Table	Integrations > Notification button	Integrations > Terminal API > Pay@Table	Previously called Notification button.
Show Payment button	Show start button	Integrations > Standalone	Previously called Show start button.
Enable tipping when using OPI	OPI > Enable gratuity	Integrations > OPI	Previously called Enable gratuity.

Deprecated settings

The following settings have been removed from Device settings, unless noted otherwise.

Setting	Old path
Animated logo	Customization
Skip signature	Customization > Signature and device name
Show merchant reference	Integrations > Standalone
Diagnostics	Diagnostics
OS for Bluetooth manager	Connectivity > Bluetooth
Adyen Giving	Payment features