---
title: "Tokenize a Card"
method: POST
path: "/vault/v1/tokens/card"
tags: ["Card Tokenization"]
---

# Tokenize a Card

`POST /vault/v1/tokens/card`

Accepts card data along with optional billing details, tokenizes the card,
and securely stores the tokenized payment method. Returns a token ID that can be
used in place of the card number for future transactions.

Authentication is done via Cloudbeds JWT

## Headers

- `X-Property-Id` string

## Request body

- TokenizeCardRequest — Tokenize Card Request
  - `card_number` string, required — The full card number.
  - `cvv` string, required — The card verification value.
  - `card_brand` string — The card brand. Supported values: VISA, MASTERCARD, AMEX, DISCOVER, etc. Defaults to VISA when omitted.
  - `cardholder_name` string, required — The name on the card.
  - `expiration` Expiration, required — Card expiration date.
    - `month` string, required — Two-digit expiration month.
    - `year` string, required — Four-digit expiration year.
  - `billing_details` BillingDetails — Billing address and contact information.
    - `address1` string — Street address line 1.
    - `address2` string — Street address line 2.
    - `city` string — City.
    - `country` string — Two-letter country code (ISO 3166-1 alpha-2).
    - `document_number` string — Tax or identification document number.
    - `name` string — Billing contact name.
    - `postal_code` string — Postal or ZIP code.
    - `phone` string — Phone number.
    - `state` string — State or province code.

## Response `200`

- TokenizeCardResponse — Tokenize Card Response
  - `id` string — The UUID of the tokenized payment method.

---

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