Suporte

Criar Token

Criar Card Token

post

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.

Autorizações
Corpo
holderNamestring · máx: 255Obrigatório

Nome do portador do cartão conforme impresso no cartão

Example: JOSE DAS NEVES TEST
numberstringObrigatório

Número do cartão de crédito

Example: 5383638854440891Pattern: ^\d{13,19}$
cvvstringObrigatório

Código de segurança do cartão (CVV/CVC)

Example: 220Pattern: ^\d{3,4}$
expirationstringObrigatório

Data de expiração no formato MM/AAAA

Example: 12/2025Pattern: ^(0[1-9]|1[0-2])\/\d{4}$
checkZeroDollarbooleanOpcional

Campo opcional: true executa verificação de zero dólar no cartão

Default: falseExample: false
buyerUuidstring · uuidObrigatório

UUID do comprador associado ao cartão

Example: a70876b3-5d2d-4038-bb75-3c25d8471507
Respostas
201

Token de cartão criado com sucesso

application/json
post
POST /payment/v1/cards HTTP/1.1
Host: api.barte.com
X-Token-Api: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 174

{
  "holderName": "JOSE DAS NEVES TEST",
  "number": "5383638854440891",
  "cvv": "220",
  "expiration": "12/2025",
  "checkZeroDollar": false,
  "buyerUuid": "a70876b3-5d2d-4038-bb75-3c25d8471507"
}
{
  "uuid": "80efb136-e65e-4fa3-b76a-6ee5a1953c4c",
  "status": "ACTIVE",
  "createdAt": "2025-08-21",
  "brand": "mastercard",
  "cardHolderName": "JOSE DAS NEVES TEST",
  "cvvChecked": true,
  "fingerprint": "d1Epx4VTTGp1KdCtVvcGK0oPA//ZR6jMlEcrdVjbt28=",
  "first6digits": "518688",
  "last4digits": "5601",
  "buyerId": "6a77d1bb-8589-4402-b5e1-2bece903daa6",
  "expirationMonth": "10",
  "expirationYear": "2025",
  "cardId": "83d353d2-716f-45cf-837f-50c18f10efa0"
}
AnteriorCartão Tokenizado (One Buy Click)PróximoRecuperar Card Token

Atualizado

Isto foi útil?