---
title: "Create a gift card token"
method: POST
path: "/v1/tokens"
tags: ["TOKENS"]
---

# Create a gift card token

`POST /v1/tokens`

**Prerequisite:** [Generate an Ecommerce API key (PAKMS key)](https://docs.clover.com/dev/docs/generate-ecommerce-api-key-or-pakms-key).

**Description:** Activates a <<glossary:physical gift card>>. Also, creates and activates a <<glossary:virtual gift card>> with a promotional code. 

**Tutorial:** [Create a gift card token](https://docs.clover.com/dev/docs/create-a-gift-card-token).

**Next steps**: Use the gift card token to [create a charge](https://docs.clover.com/reference/createcharge) or [pay for an order](https://docs.clover.com/reference/postordersidpay) and with the [Gift Card API endpoints](https://docs.clover.com/dev/docs/gift-card-api).

## Headers

- `apikey` string, uuid, required
- `User-Agent` string, required

## Request body

- object
  - `gift_card` object — Gift card details, including metadata. For more information, see [Use the Clover Ecommerce Gift Card API](https://docs.clover.com/dev/docs/gift-card-api).
    - `number` string, required — Gift card number. Format: Numeric only Length: 6, 13, 16, or 19 digits
    - `security_code` string — Encrypted security code value (SCV) associated with the gift card. Length: 4-8 characters

## Response `200`

Successful response. Gift card token generated.

- object
  - `id` string — Unique identifier of the gift card.
  - `token` string — Clover token to perform gift card transactions.
  - `gift_card` object — Gift card details.
    - `last4` string — Last 4 digits of the gift card number.

## Other responses

- `400` — Bad request.
- `401` — Authorization information is missing or invalid.
- `5XX` — Unexpected error.

---

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