Account - company level3

Account - merchant level4

Account - store level8

Allowed origins - company level4

Allowed origins - merchant level4

Android files - company level3

API credentials - company level4

API credentials - merchant level4

API key - company level1

API key - merchant level1

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

Terminals - terminal level1

Users - company level4

Users - merchant level4

Webhooks - company level7

Webhooks - merchant level7

Terminal settings - store level

Update terminal settings

Updates payment terminal settings for the store identified in the path. These settings apply to all terminals under the store, unless different values are configured for an individual terminal.

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/merchants/{merchantId}/stores/{reference}/terminalSettings

Path parameters

merchantIdstring required

The unique identifier of the merchant account.

referencestring required

The reference that identifies the store.

Request body

Response

OK - the request has succeeded.

Changes

Changed in 13 of the 50 revisions of this API.22452

Jul 13, 2026v11089ade06e172See the full diff
- ○
  added the new optional request property surcharge/disclosureOnPresentCard
  new-optional-request-property
- ○
  added the optional property surcharge/disclosureOnPresentCard to the response with the 200 status
  response-optional-property-added
May 19, 2026v144a2af25ea762See the full diff
- ●
  removed the request property offlineProcessing/offlineSwipeLimits
  request-property-removed
- ●
  removed the optional property offlineProcessing/offlineSwipeLimits from the response with the 200 status
  response-optional-property-removed
May 1, 2026v1021e794dcb716See the full diff
- ○
  added the new optional request property dcc
  new-optional-request-property
- ○
  added the new optional request property receiptOptions/headerLine1
  new-optional-request-property
- ○
  added the new optional request property receiptOptions/headerLine2
  new-optional-request-property
- ○
  added the optional property dcc to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property receiptOptions/headerLine1 to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property receiptOptions/headerLine2 to the response with the 200 status
  response-optional-property-added
Feb 2, 2026v19d52dc387cf94See the full diff
- ○
  added the new optional request property homeScreen
  new-optional-request-property
- ○
  added the new optional request property kioskMode
  new-optional-request-property
- ○
  added the optional property homeScreen to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property kioskMode to the response with the 200 status
  response-optional-property-added
Dec 10, 2025v10324491ea01e2See the full diff
- ●
  removed the request property moto/enableRefunds
  request-property-removed
- ●
  removed the optional property moto/enableRefunds from the response with the 200 status
  response-optional-property-removed
Dec 4, 2025v15fb10acea9242See the full diff
- ○
  added the new optional request property moto
  new-optional-request-property
- ○
  added the optional property moto to the response with the 200 status
  response-optional-property-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Aug 19, 2025v16bf7b78383762See the full diff
- ○
  added the new optional request property refunds/unreferenced
  new-optional-request-property
- ○
  added the optional property refunds/unreferenced to the response with the 200 status
  response-optional-property-added
May 14, 2025v147d3dd16c9c74See the full diff
- ○
  added the new optional request property standalone/enableGratuities
  new-optional-request-property
- ○
  added the new optional request property wifiProfiles/profiles/items/domainSuffix
  new-optional-request-property
- ○
  added the optional property standalone/enableGratuities to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property wifiProfiles/profiles/items/domainSuffix to the response with the 200 status
  response-optional-property-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Feb 26, 2025v10e4302cd15112See the full diff
- ○
  added the new optional request property surcharge/excludeGratuityFromSurcharge
  new-optional-request-property
- ○
  added the optional property surcharge/excludeGratuityFromSurcharge to the response with the 200 status
  response-optional-property-added
Oct 15, 2024v1a84d5fa154d74See the full diff
- ○
  added the new optional request property surcharge/configurations/items/commercial
  new-optional-request-property
- ○
  added the new optional request property surcharge/configurations/items/currencies/items/maxAmount
  new-optional-request-property
- ○
  added the optional property surcharge/configurations/items/commercial to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property surcharge/configurations/items/currencies/items/maxAmount to the response with the 200 status
  response-optional-property-added

Full history (13 revisions)