---
title: "Create terminal"
method: POST
path: "/terminal"
tags: ["Terminals"]
---

# Create terminal

`POST /terminal`

Creates a new terminal (POS device).

**Required scope:** <code style="background:#e8f0fe;color:#1a73e8;padding:2px 8px;border-radius:12px;font-size:0.85em">terminal:create</code>

## Request body

- object
  - `serial_number` string, required — The serial number of the terminal device. Unique per acquirer.
  - `name` string, required — The name of the terminal. Must be unique.
  - `acquirer` 'VERIFONE', required — The acquirer associated with the terminal.

## Response `201`

Created

- Terminal — Terminal (POS) object representing a payment terminal device.
  - `id` string, uuid — The unique identifier of the terminal.
  - `serial_number` string — The serial number of the terminal device. Unique per acquirer.
  - `name` string — The name of the terminal. Must be unique.
  - `status` 'ACTIVE' | 'INACTIVE' | 'DELETED' — The current status of the terminal. Determined by the device state.
  - `acquirer` 'VERIFONE' — The acquirer associated with the terminal.
  - `model` string — The model of the terminal device. Inferred from the serial number.
  - `last_transaction_at` string, date-time, nullable — The date and time of the last transaction processed by the terminal. Null if no transactions have been processed.
  - `created_at` string, date-time — The date and time when the terminal was created.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `409` — Conflict
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/easypay/apis/easypay-payments-api.md) · [All operations](https://skmtc.net/easypay/apis/easypay-payments-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/easypay/easypay-payments-api/versions/cdf25a9ad7b2/schema)