---
title: "Register a terminal with AWS IoT Core"
method: POST
path: "/v3/terminal/register"
tags: ["Terminal"]
---

# Register a terminal with AWS IoT Core

`POST /v3/terminal/register`

## Request

- Base URL: `https://testpayarcconnectapi.payarc.net`
- URL: `https://testpayarcconnectapi.payarc.net/v3/terminal/register`
- Auth: none required

This API Endpont allows the user to register a terminal with AWS IoT Core.

## Request body

- TerminalRegisterRequest
  - `serialNumber` string, required: Serial number of the terminal
  - `model` string, required: Model of the terminal
  - `tenantId` string, required: 12-digit merchant identifier (MID).

## Response `200`

Terminal Registered Successfully

- TerminalRegisterSuccessResponse
  - `terminalName` string, required: AWS IoT name associated with the terminal
  - `certificatePem` string, required: X.509 device certificate in PEM format
  - `privateKeyPem` string, required: Private key in PEM format
  - `rootCaPem` string, required: AWS IoT Root CA in PEM format
  - `iotEndpoint` string, required: AWS IoT MQTT endpoint the terminal should connect to
  - `certificateExpiration` string: Date in which the IoT Certificate expires

## Other responses

- `400`: Invalid Request

---

[API](https://skmtc.dev/payarc/apis/payarc-connect-v3.md) - [All operations](https://skmtc.dev/payarc/apis/payarc-connect-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/payarc/apis/payarc-connect-v3/revisions/78418d530627?raw)