---
title: "Delete card tokens"
method: POST
path: "/pay/v3/deleteToken"
tags: ["Ecommerce"]
---

# Delete card tokens

`POST /pay/v3/deleteToken`

Allows you to delete card or terminal tokens from the card vault.

<!-- theme: info -->
> 📘 Note
> 
> Cards registered with the account updater service may take up to 72 hours to be removed.

<!-- theme: warning -->
> ⚠️ Try It
>
> To use the Try It feature for this endpoint, you can use the credentials for your [Sandbox API user](https://docs.nexiopay.com/docs/sandbox-environments).<br/><br/>You can also use the following test account. Copy the value and paste it into the appropriate space in the Try It section to the right.
> username: `docs@nexiopay.com`
> password: `JZdzoXpdDeH6VA`<br/><br/>Include an array of one or more existing card or terminal tokens in the body of the request.

<div style="display:none;">

## Request parameters
- tokens

## Response parameters
- key
- message
- status
- error
- error.0
- error.0.message
- error.0.tableName
- error.1
- error.1.message
- error.1.cardError

</div>

## Request body

- object
  - `tokens` string[], required — An array of card or terminal tokens.

## Response `200`

Success

- object[]
  - `key` string — The card or terminal token that has been deleted.
  - `message` string — A message indicating the status of the request, such as "Successfully removed from vault" or "Unable to find token".
  - `error` object — The error message information, if applicable.
    - `0` object
      - `message` string — A message describing the error.
      - `tableName` string — Information related to the error message.
    - `1` object
      - `cardError` boolean
      - `message` string — A message describing the error.
  - `status` string — The status of the request. Value may be `success` or `failure`.

## Other responses

- `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)