Changes the settings of the payter terminal identified by {type}_{id} (e.g. payter_123). Only the fields sent are changed; omitted fields keep their value. Read the current settings from payterSettings on GET /payment-terminals or GET /payment-terminals/{id}.
When changes reach the terminal: nothing is pushed to the device. maxReservationAmount, tapToStop, rfid and locale apply from the next session. touchscreen and startScreen show the next time the idle screen is redrawn: right after a session, or within about 75 minutes on a terminal with no traffic.
Bulk: there is no bulk endpoint. To change many terminals, list them (filter on hardwareModel client-side, e.g. apollo) and call this endpoint once per terminal, staying within your rate limit.
Required scope: payment-terminals:write
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
422Validation failed, e.g. a negative maxReservationAmount, an unknown locale, or touchscreen/startScreen sent for a terminal that is not an apollo