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, or open the terminal menu, 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.

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

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

One operation at a time

List operation results

Operation status

Scopes

​Available operations

​Send a command

​Idempotency

​One operation at a time

​List operation results

​Operation status

​Scopes

Available operations

Send a command

Idempotency

One operation at a time

List operation results

Operation status

Scopes