---
title: "Create a local payment terminal"
method: POST
path: "/api/v1/payment-terminals/local"
tags: ["Payment Terminals"]
---

# Create a local payment terminal

`POST /api/v1/payment-terminals/local`

Create a local (offline) payment terminal owned by the given team.<br>Required scope: `payment-terminals:write`

## Request body

- CreateLocalPaymentTerminalDto
  - `teamId` integer, required — The team that owns the local payment terminal.
  - `payingTeamId` integer, required — The team that pays for charges started on this terminal.
  - `idTag` string, required — The id tag (or prefix) used to authorize charges on this terminal.
  - `idTagPrefix` boolean, required — If true, the id tag is treated as a prefix (any tag starting with this value is accepted).
  - `name` string, required — Display name of the local payment terminal.
  - `priceLimit` number, double, nullable — Optional spending limit (in the team's currency) per charge.

## Response `201`

Local payment terminal created

- PaymentTerminal
  - `id` string, required — Id of this terminal. **NOTE: This is a String**
  - `type` 'payter' | 'local' | 'other', required
  - `teamId` integer — The team this terminal belongs to
  - `chargePointIds` integer[], required — The charge points ids this terminal is assigned to
  - `serial` string, required — Serial number of the Payment Terminal
  - `name` string, required — Name given to the Payment Terminal, defaults to "No Name" if not set by the merchant
  - `isConnected` boolean — Indicates if the terminal is connected or disconnected.
  - `connectedAt` string, date-time, nullable — Date this payment terminal did connect
  - `createdAt` string, date-time, required — Date this entity was created
  - `updatedAt` string, date-time, nullable — Date this entity was updated
  - `deletedAt` string, date-time, nullable — Date this entity was deleted

## Other responses

- `400` — The request is invalid
- `401` — Consumer with provided credentials was not found
- `403` — Operator doesn't have access to resource
- `404` — Entity with the provided id was not found

---

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