Skip to content
/
Update terminal

Update terminal

Request

Updates the terminal details.

Required scope: terminal:update

Security
accountId and apiKey
Path
idstring, (uuid)required

Resource Identification

Bodyapplication/jsonrequired

Terminal object to update an existing terminal

namestring, <= 255 characters

The name of the terminal. Must be unique.

Example:"Terminal Checkout 2"
curl -i -X PATCH \
  'https://api.test.easypay.pt/2.0/terminal/{id}' \
  -H 'AccountId: 2b0f63e2-9fb5-4e52-aca0-b4bf0339bbe6' \
  -H 'ApiKey: eae4aa59-8e5b-4ec2-887d-b02768481a92' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Terminal Checkout 2"
  }'

Responses

OK

Bodyapplication/json
idstring, (uuid)

The unique identifier of the terminal.

Example:"458b2fc4-3092-4de3-abd4-fe1600c09420"
serial_numberstring

The serial number of the terminal device. Unique per acquirer.

Example:"123-456-789"
namestring

The name of the terminal. Must be unique.

Example:"Terminal Checkout 1"
statusstring

The current status of the terminal. Determined by the device state.

Enum:"ACTIVE""INACTIVE""DELETED"
Example:"ACTIVE"
acquirerstring

The acquirer associated with the terminal.

Value:"VERIFONE"
Example:"VERIFONE"
modelstring

The model of the terminal device. Inferred from the serial number.

Example:"V240m"
last_transaction_atstring or null, (date-time)

The date and time of the last transaction processed by the terminal. Null if no transactions have been processed.

Example:"2025-08-05T13:44:29Z"
created_atstring, (date-time)

The date and time when the terminal was created.

Example:"2025-08-05T13:44:29Z"
Response
Success
{
  "id": "458b2fc4-3092-4de3-abd4-fe1600c09420",
  "serial_number": "123-456-789",
  "name": "Terminal Checkout 2",
  "status": "ACTIVE",
  "acquirer": "VERIFONE",
  "model": "V240m",
  "last_transaction_at": "2025-08-05T13:44:29Z",
  "created_at": "2025-08-01T10:00:00Z"
}