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

# Terminals:Create

`POST /terminals`

Create a terminal for a service location from a merchant so that the terminal can be used.

## Request body

- object
  - `serviceId` Id, required — unresolved $ref
  - `activationCode` string, required — The code needed to activate your terminal.
  - `name` string, required — The name of your terminal.
  - `description` string — The description for your terminal.
  - `enableRefunds` boolean — Enable the ability to refund on this terminal

## Response `200`

Ok.

- object
  - `code` Code — unresolved $ref
  - `name` Name — unresolved $ref
  - `attribution` Attribution — unresolved $ref
  - `status` Status — unresolved $ref
  - `connectionStatus` ConnectionStatus — unresolved $ref
  - `merchant` MerchantMinimal
    - `code` string, required — The merchant id of your company starting with M.
    - `name` string, required — The name of your merchant.
    - `status` string, required — Merchant state
    - `incorporationCountry` string — The incorporationCountry field represents the country in which the entity is legally registered or incorporated.
  - `service` object
    - `id` Id — unresolved $ref
    - `status` Status — unresolved $ref
    - `name` Name — unresolved $ref
    - `mcc` string — The Merchant Category Code (mcc) of this service.
  - `tradeName` object
    - `code` Code — unresolved $ref
    - `name` Name — unresolved $ref
  - `description` Description — unresolved $ref
  - `hardwareCode` HardwareCode — unresolved $ref
  - `serialNumber` SerialNumber — unresolved $ref
  - `terminalType` TerminalType — unresolved $ref
  - `supplier` Supplier — unresolved $ref
  - `ecrProtocol` EcrProtocol — unresolved $ref
  - `contractStartDate` ContractStartDate — unresolved $ref
  - `contractEndDate` ContractEndDate — unresolved $ref
  - `paymentTypes` PaymentTypes — unresolved $ref
  - `terminalBrands` TerminalBrand
    - `id` integer — The terminal contract enddate.
    - `name` string — The terminal contract enddate.
    - `image` string — The terminal contract enddate.
    - `acquirer` string — The terminal acquirer
    - `acquirerTid` string — The terminal contract enddate.
    - `acquirerMid` string — The terminal contract number
    - `acquirerChecksum` string — The terminal contract enddate.
    - `paymentTypes` object[] — The terminal payment type.
      - `paymentType` string
    - `createdAt` CreatedAt — unresolved $ref
    - `createdBy` CreatedBy — unresolved $ref
    - `modifiedAt` ModifiedAt — unresolved $ref
    - `modifiedBy` ModifiedBy — unresolved $ref
    - `deletedAt` DeletedAt — unresolved $ref
    - `deletedBy` DeletedBy — unresolved $ref
  - `location` object
    - `streetName` StreetName — unresolved $ref
    - `streetNumber` StreetNumber — unresolved $ref
    - `zipCode` ZipCode — unresolved $ref
    - `city` City — unresolved $ref
    - `countryCode` CountryCode — unresolved $ref
  - `settings` Settings — unresolved $ref
  - `createdAt` CreatedAt — unresolved $ref
  - `createdBy` CreatedBy — unresolved $ref
  - `modifiedAt` ModifiedAt — unresolved $ref
  - `modifiedBy` ModifiedBy — unresolved $ref
  - `deletedAt` DeletedAt — unresolved $ref
  - `deletedBy` DeletedBy — unresolved $ref
  - `_links` object
    - `first` object
      - `href` Href — unresolved $ref
    - `previous` object
      - `href` Href — unresolved $ref
    - `next` object
      - `href` Href — unresolved $ref
    - `last` object
      - `href` Href — unresolved $ref
    - `self` object
      - `href` Href — unresolved $ref
      - `rel` Rel — unresolved $ref
      - `type` Type — unresolved $ref

## Other responses

- `401` — Unauthorized. Supplied credentials are invalid
- `403` — Forbidden. Supplied credentials have no rights
- `404` — Resource not found
- `405` — Used HTTP method is not allowed
- `406` — Not acceptable. The supplied content type in the accept parameter in the header is not supported
- `429` — Rate limit reached.
- `500` — An internal error occurred

---

[API](https://skmtc.dev/pay/apis/pay-transaction-gateway-unit-api.md) · [All operations](https://skmtc.dev/pay/apis/pay-transaction-gateway-unit-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pay/pay-transaction-gateway-unit-api/revisions/2bc260c7bdfc/schema)