---
title: "Register new Terminal"
method: POST
path: "/registerTerminal"
tags: ["Merchant Portal services API"]
---

# Register new Terminal

`POST /registerTerminal`

## Request

- Base URL: `https://test.tecs.at/merchantservices`
- URL: `https://test.tecs.at/merchantservices/registerTerminal`
- Auth: HTTP bearer

Register new Terminal by given template name.<br>
Register Enable Acquiring.<br>
Registers also new merchant in TecsWeb, if merchant's target is 'tecsweb' in template.<br>
Required role for operation: TE_MERCHANT_TERMINAL_MANAGEMENT.<br>
Create MPauditlog table record with event type : RegisterTerminal<br> 
Supported authentication:<br>
* Bearer &lt;token&gt; - which is a Bearer token authentication

## Request body

- RegisterTerminalRequest
  - `corporateUuid` string, required
  - `packageOrderUuid` string, required
  - `productOrderUuid` string, required
  - `templateName` string, required
  - `terminalLocation` string, required
  - `terminalCountryCode` string, required
  - `terminalLanguageCode` string, required
  - `terminalSerialNumber` string
  - `webShopUrl` string
  - `tokenIOIban` string
  - `terminalIdAcq` string
  - `additionalData` object

## Response `200`

Successful operation

- RegisterTerminalResponse
  - `responseCode` integer
  - `responseMessage` string
  - `terminalId` integer
  - `tecsWebSecretKey` string
  - `tokenIOAlias` string
  - `tokenIOMemberId` string

## Other responses

- `400`: * Mandator not found * Invalid template * Invalid TECS company specified * MandatorConfig not found * Invalid country code Alpha3 specified
- `401`: Unauthorized - Authentication failed, e.g. when user is not active
- `403`: Forbidden - Missing role: TE_MERCHANT_TERMINAL_MANAGEMENT
- `500`: * Internal server error * Error getting Corporate Account

## Changes

- **2026-11-03** `6e0e5a5a2b2f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bluefin-com/apis/merchant-services/changes/registerTerminal/post.md)

---

[API](https://skmtc.dev/bluefin-com/apis/merchant-services.md) - [All operations](https://skmtc.dev/bluefin-com/apis/merchant-services/llms.txt) - [OpenAPI document](https://skmtc.dev/bluefin-com/apis/merchant-services/revisions/6e0e5a5a2b2f?raw)