---
title: "Criar Card Token"
method: POST
path: "/payment/v1/cards"
tags: ["Tokenização de Cartões"]
---

# Criar Card Token

`POST /payment/v1/cards`

Cria um token seguro para um cartão de crédito, permitindo armazenamento seguro e reutilização dos dados do cartão sem expor informações sensíveis. ⚠️ IMPORTANTE: Criar card token com CVV falso retornará status PENDING e causará erro na criação da cobrança.

## Request body

- CreateCardTokenRequest
  - `holderName` string, required — Nome do portador do cartão conforme impresso no cartão
  - `number` string, required — Número do cartão de crédito
  - `cvv` string, required — Código de segurança do cartão (CVV/CVC)
  - `expiration` string, required — Data de expiração no formato MM/AAAA
  - `checkZeroDollar` boolean — Campo opcional: true executa verificação de zero dólar no cartão
  - `buyerUuid` string, uuid, required — UUID do comprador associado ao cartão

## Response `201`

Token de cartão criado com sucesso

- CardTokenResponse
  - `uuid` string, uuid — UUID do token criado (usar como cardToken na criação de pedidos)
  - `status` 'ACTIVE' | 'PENDING' | 'INACTIVE' — Status do token (ACTIVE = válido, PENDING = verificação pendente)
  - `createdAt` string, date — Data de criação do token
  - `brand` 'visa' | 'mastercard' | 'elo' | 'american_express' | 'hipercard' | 'diners' — Bandeira do cartão
  - `cardHolderName` string — Nome do portador do cartão
  - `cvvChecked` boolean — Indica se o CVV foi verificado
  - `fingerprint` string — Fingerprint único do cartão
  - `first6digits` string — Primeiros 6 dígitos do cartão
  - `last4digits` string — Últimos 4 dígitos do cartão
  - `buyerId` string, uuid — UUID do comprador
  - `expirationMonth` string — Mês de expiração
  - `expirationYear` string — Ano de expiração
  - `cardId` string, uuid — ID único do cartão (usar para o fluxo de 3DS)

## Other responses

- `400` — Requisição inválida
- `401` — Não autorizado
- `403` — Acesso proibido
- `500` — Erro interno do servidor

---

[API](https://skmtc.net/barte/apis/api-de-sellers-v2-atualizada.md) · [All operations](https://skmtc.net/barte/apis/api-de-sellers-v2-atualizada/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/barte/api-de-sellers-v2-atualizada/revisions/f0dd55b167f1/schema)