Manage terminals remotely

Terminal operations let you send administrative commands to a registered payment terminal and read the results. Use them to run an end-of-day close, ask the terminal to upload its logs, check for software updates, open the terminal menu, or ping the terminal to see whether it is reachable, without physically touching the device. Operations are asynchronous. You send a command, the API dispatches it to the terminal and returns immediately with a PENDING operation, and the terminal processes the command in the background. You then poll the operation to see how it finished.

Terminal operations are administrative commands. They do not start a payment. To take a payment on a terminal, see creating a terminal session.

Available operations

Operation	Description
`end_of_day`	Run the end-of-day routine on the terminal.
`send_logs`	Instruct the terminal to upload its logs.
`check_update`	Have the terminal check for a software update.
`open_menu`	Open the settings menu on the terminal.
`poll_terminal`	Ping the terminal to check whether it is online and responding.

Send a command

POST https://api.dintero.com/v1/accounts/{account_id}/payments/admin/terminals/operations
Authorization: Bearer <token>
Content-Type: application/json

The request body identifies the terminal and the operation to run.

{
  "terminal_id": "P11223351-T0013",
  "operation": "end_of_day"
}

The response is returned as soon as the command is dispatched to the terminal. The terminal’s response is processed asynchronously, so the operation starts with status PENDING.

{
  "id": "3f1a9c2e-8b7d-4f6a-9c1e-2d5b8a0f4e6c",
  "terminal_id": "P11223351-T0013",
  "operation": "end_of_day",
  "status": "PENDING",
  "created_at": "2026-06-29T09:00:00Z",
  "created_by": "user@example.com",
  "updated_at": "2026-06-29T09:00:00Z",
  "updated_by": "user@example.com"
}

See POST /admin/terminals/operations for the full schema.

Idempotency

Pass an Idempotency-Key header to ensure the same command is only executed once, for example when retrying after a network error.

Idempotency-Key: 9b2c5d7e-1a3f-4c6b-8d9e-0f1a2b3c4d5e

Check that a terminal is reachable

The poll_terminal operation pings the terminal without changing anything on the device. Use it to confirm that a terminal is online and responding, for example before you send another operation or when you are investigating a terminal that customers report as unresponsive.

{
  "terminal_id": "P11223351-T0013",
  "operation": "poll_terminal"
}

poll_terminal can be sent regardless of the terminal’s status, so you can also use it on a terminal that is not ACTIVE. The operation ends as COMPLETED when the terminal answers, and as TIMEOUT when no answer arrives within the timeout window.

One operation at a time

A terminal processes one operation at a time. If an operation is already pending for the terminal, the API responds with 409 Conflict and a Retry-After header indicating how many seconds to wait before retrying.

List operation results

Poll operations to see how a command finished. The endpoint returns operations and supports filtering by terminal_id and operation_id.

GET https://api.dintero.com/v1/accounts/{account_id}/payments/admin/terminals/operations?terminal_id=P11223351-T0013
Authorization: Bearer <token>

To check a single operation, filter by the id returned when you sent the command.

GET https://api.dintero.com/v1/accounts/{account_id}/payments/admin/terminals/operations?operation_id=3f1a9c2e-8b7d-4f6a-9c1e-2d5b8a0f4e6c
Authorization: Bearer <token>

See GET /admin/terminals/operations for the full schema.

Operation status

Status	Meaning
`PENDING`	The operation has been dispatched to the terminal and is awaiting a response.
`COMPLETED`	The terminal responded and the operation finished successfully.
`FAILED`	The terminal responded but reported a failure.
`TIMEOUT`	No response was received from the terminal within the timeout window. A new operation can be dispatched.

Scopes

Endpoint	Scopes
`POST /accounts/{account_id}/payments/admin/terminals/operations`	`admin:checkout` or `write:checkout:/admin/terminals`
`GET /accounts/{account_id}/payments/admin/terminals/operations`	`admin:checkout` or `read:checkout:/admin/terminals`

Checkout Integration

Express Checkout

Payment Methods

Tokenization

Split Payout

In-Person Payments

Available operations

Send a command

Idempotency

Check that a terminal is reachable

One operation at a time

List operation results

Operation status

Scopes

​Available operations

​Send a command

​Idempotency

​Check that a terminal is reachable

​One operation at a time

​List operation results

​Operation status

​Scopes

Available operations

Send a command

Idempotency

Check that a terminal is reachable

One operation at a time

List operation results

Operation status

Scopes