---
title: "Create a card token for use with subsequent payments"
method: POST
path: "/v1/card/tokens"
tags: ["CARD"]
---

# Create a card token for use with subsequent payments

`POST /v1/card/tokens`

A call to the token endpoint is used to create either a single-use or multi-pay token that can be used for subsequent transactions.  Note: Tokenization through REST Pay Display API is not supported in  Europe.

## Headers

- `User-Agent` string, required
- `X-Clover-Device-Id` string, required
- `X-POS-Id` string, required
- `X-Clover-Timeout` integer
- `Idempotency-Key` string

## Request body

- TokenRequest — A request to generate a token for use in subsequent transactions.
  - `cardEntryMethods` CardEntryMethod[] — A collection of supported card entry methods for the operation.
  - `tokenType` string — The type of token requested. If not specified, a Clover legacy token will be returned. Supported values: ECOMM_COMPAT

## Response `200`

A token was created.

- TokenResponse — The information about the created token
  - `expirationDate` string, #### — A four-digit number representing the expiraction month (first two digits) and year (last two digits)
  - `first6` string, ###### — The first 6 digits
  - `last4` string, #### — The last 4 digits
  - `name` string
  - `token` string — A string representing a token which may be used in a future payment operation
  - `tokenType` string

## Other responses

- `209` — Operation was canceled.
- `400` — The request is invalid, and subsequent calls will continue to fail; do not repeat the call.
- `401` — An invalid bearer token has been provided. The call may be repeated if the provided bearer token is updated.
- `415` — The request is invalid, and contains request data in an unsupported format. This call may be repeated if the content is changed to a supported format.
- `500` — The request processing failed with an unknown error, and the processing state of the operation is indeterminate. Do not repeat the call without additional analysis.
- `501` — The device does not have the ability to respond to the requested operation; do not repeat the call.
- `503` — The device is not available because it is currently servicing another call. This can be repeated at a later time, or cancel may be called to end the current operation.
- `504` — The Device did not respond in a timely manner. This can be repeated at a later time.

---

[API](https://skmtc.net/clover/apis/platform-api.md) · [All operations](https://skmtc.net/clover/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clover/platform-api/revisions/08da265101a3/schema)