---
title: "Deregister terminal"
method: POST
path: "/pay/v3/deregisterTerminal"
tags: ["Retail"]
---

# Deregister terminal

`POST /pay/v3/deregisterTerminal`

Removes a terminal's registration through the Nexio API. 

<!-- theme: info -->
> 📘 Notes
> 
> - In addition to this API, you can deregister a terminal directly within the gateway user interface.
> - You can only deregister terminals that have already been [registered](https://docs.nexiopay.com/reference/registerterminal) with Nexio. 
> - You may need to deregister a terminal in situations such as when the terminal needs to be used with a different gateway account.

For a tutorial on how to use this endpoint, see the [Registering and deregistering terminals](https://docs.nexiopay.com/docs/registering-and-deregistering-terminals) topic in **Guides**.

<!-- theme: warning -->
> ⚠️ Try It
> 
> To use the Try It feature for this endpoint, you must use the credentials for your [Sandbox API user](https://docs.nexiopay.com/docs/sandbox-environments) and you must have an account with a gateway that supports terminal registration.

<div style="display:none;">

## Request parameters
- terminalId

## Response parameters
- terminalRegistrationStatus

</div>

## Request body

- object
  - `terminalId` string, required — The Nexio terminal ID. Get this value from the [View terminal list](https://docs.nexiopay.com/reference/viewterminallist) endpoint.

## Response `200`

Success

- object
  - `terminalRegistrationStatus` 'registered' | 'pending' | 'failed' | 'deregistered' — The current registration status of the terminal.
  - `random-4611765` RandomNnnn — unresolved $ref

## Other responses

- `400` — Bad Request. For help with this error and other error codes, see [Common errors](https://docs.nexiopay.com/docs/common-errors) in the Guides area.
- `401` — Unauthorized. For help with this error and other error codes, see [Common errors](https://docs.nexiopay.com/docs/common-errors) in the Guides area.

---

[API](https://skmtc.dev/nexiopay/apis/payments-api-reference.md) · [All operations](https://skmtc.dev/nexiopay/apis/payments-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nexiopay/payments-api-reference/revisions/b414b73979e5/schema)