---
title: "aid_account_management_terminals_post"
method: POST
path: "/accounts/{aid}/terminals"
tags: ["account-terminals"]
---

# aid_account_management_terminals_post

`POST /accounts/{aid}/terminals`

Register a physical payment terminal and associate it with a store.

scopes:
- admin:accounts
- write:accounts

## Path parameters

- `aid` string, ^[PT]{1}\d{8}$, required

## Request body

- TerminalInput
  - `device_serial_number` string, required — Hardware serial number printed on the device.
  - `store_id` string, required — The client-supplied `store_id` of the store to associate this terminal with.

## Response `200`

Terminal

- Terminal
  - `id` string, uuid — An UUID that uniquely identifies the resource
  - `created_at` string, date-time — The date-time when the resource was created
  - `created_by` string — The ID of the user/client created the resource
  - `updated_at` string, date-time — The date-time when the resource was last updated
  - `deleted_by` string — The ID of the user/client created the resource
  - `deleted_at` string, date-time
  - `device_model` string
  - `store_id` string
  - `terminal_id` string, required
  - `device_serial_number` string, required
  - `status` 'DELETED' | 'PENDING' | 'ACTION_REQUIRED' | 'ACTIVE' | 'INACTIVE' | 'ERROR' — The status of the terminal
  - `status_reason` 'CHECK_UPDATE' — Context explaining why the terminal has its current status.

## Other responses

- `400` — Bad / Invalid request
- `401` — Access forbidden, invalid JWT token was used
- `403` — Forbidden
- `500` — Unexpected Error

---

[API](https://skmtc.net/dintero/apis/account-management-api.md) · [All operations](https://skmtc.net/dintero/apis/account-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dintero/account-management-api/revisions/9b83a4199008/schema)