Criar Token do Cartão

Criar Card Token

post

https://api.barte.comhttps://sandbox-api.barte.com

/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.

Authorizations

X-Token-Api

X-Token-ApistringRequired

Body

application/json

holderNamestring · max: 255Required

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

Example: JOSE DAS NEVES TEST

numberstringRequired

Número do cartão de crédito

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

cvvstringRequired

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

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

expirationstringRequired

Data de expiração no formato MM/AAAA

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

checkZeroDollarbooleanOptional

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

Default: falseExample: false

buyerUuidstring · uuidRequired

UUID do comprador associado ao cartão

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

Responses

201

Token de cartão criado com sucesso

application/json

uuidstring · uuidOptional

UUID do token criado (usar como cardToken na criação de pedidos)

Example: 80efb136-e65e-4fa3-b76a-6ee5a1953c4c

statusstring · enumOptional

Status do token (ACTIVE = válido, PENDING = verificação pendente)

Example: ACTIVEPossible values:

createdAtstring · dateOptional

Data de criação do token

Example: 2025-08-21

brandstring · enumOptional

Bandeira do cartão

Example: mastercardPossible values:

cardHolderNamestringOptional

Nome do portador do cartão

Example: JOSE DAS NEVES TEST

cvvCheckedbooleanOptional

Indica se o CVV foi verificado

Example: true

fingerprintstringOptional

Fingerprint único do cartão

Example: d1Epx4VTTGp1KdCtVvcGK0oPA//ZR6jMlEcrdVjbt28=

first6digitsstringOptional

Primeiros 6 dígitos do cartão

Example: 518688

last4digitsstringOptional

Últimos 4 dígitos do cartão

Example: 5601

buyerIdstring · uuidOptional

UUID do comprador

Example: 6a77d1bb-8589-4402-b5e1-2bece903daa6

expirationMonthstringOptional

Mês de expiração

Example: 10

expirationYearstringOptional

Ano de expiração

Example: 2025

cardIdstring · uuidOptional

ID único do cartão (usar para o fluxo de 3DS)

Example: 83d353d2-716f-45cf-837f-50c18f10efa0

400

Requisição inválida

application/json

401

Não autorizado

application/json

403

Acesso proibido

application/json

500

Erro interno do servidor

application/json

post

/payment/v1/cards

HTTPcURLJavaScriptPython

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"
}