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

# Criar Card Token

`POST /payment/v1/cards`

## Request

- Base URL: `https://api.barte.com`
- URL: `https://api.barte.com/payment/v1/cards`
- Auth: API key in header `X-Token-Api`
- TypeScript: <https://skmtc.dev/barte/apis/api-de-sellers-v2-atualizada/docs/payment/v1/cards/post.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/barte/apis/api-de-sellers-v2-atualizada.md) - [All operations](https://skmtc.dev/barte/apis/api-de-sellers-v2-atualizada/llms.txt) - [OpenAPI document](https://skmtc.dev/barte/apis/api-de-sellers-v2-atualizada/revisions/f0dd55b167f1?raw)