Account - company level3

Account - merchant level4

Account - store level8

Allowed origins - company level4

Allowed origins - merchant level4

Android files - company level6

API credentials - company level4

API credentials - merchant level4

API key - company level1

API key - merchant level1

Client certificates - company level2

Client key - company level1

Client key - merchant level1

Donation campaigns6

My API credential6

Payment methods - merchant level6

Payout settings - merchant level5

Split configuration - merchant level9

Terminal actions - company level2

Terminal actions - terminal level1

Terminal orders - company level10

Terminal orders - merchant level10

Terminal settings - company level4

Terminal settings - merchant level4

Terminal settings - store level8

Terminal settings - terminal level4

Terminal themes - company level10

Terminal themes - merchant level10

Terminal themes - store level2

Terminal themes - terminal level2

Terminals - terminal level2

Users - company level4

Users - merchant level4

Webhooks - company level7

Webhooks - merchant level7

Terminal settings - terminal level

Update terminal settings

Changed on Sep 23, 2026

Updates the settings that are configured for the payment terminal identified in the path.

To change a parameter value, include the full object that contains the parameter, even if you don't want to change all parameters in the object.
To restore a parameter value inherited from a higher level, include the full object that contains the parameter, and specify an empty value for the parameter or omit the parameter.
Objects that are not included in the request are not updated.

To make this request, your API credential must have the following role:

Management API—Terminal settings read and write

For sensitive terminal settings, your API credential must have the following role:

Management API—Terminal settings Advanced read and write

In the live environment, requests to this endpoint are subject to rate limits.

patch/terminals/{terminalId}/terminalSettings

Request

Base URL
https://management-test.adyen.com/v3
URL
https://management-test.adyen.com/v3/terminals/{terminalId}/terminalSettings
Auth
- HTTP basic
- or API key in header X-API-Key

Path parameters

terminalIdstring required

The unique identifier of the payment terminal.

Request body

showCalculatedPercentageTippingAmountboolean nullable

Show the tipping amount calculated from the percentage next to each tipping percentage option on the terminal screen, for example 10 % | 10 EUR for a 100 EUR payment.

Response

OK - the request has succeeded.