v1

latestOpenAPI 3.0.02026-07-2340101105.4 KB

Tokenização de Cartões

Criar Card Token

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.

post/payment/v1/cards

Request body

holderNamestring required

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

numberstring required

Número do cartão de crédito

cvvstring required

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

expirationstring required

Data de expiração no formato MM/AAAA

checkZeroDollarboolean

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

buyerUuidstring uuid required

UUID do comprador associado ao cartão

Response

Token de cartão criado com sucesso

uuidstring 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)

createdAtstring date

Data de criação do token

Bandeira do cartão

cardHolderNamestring

Nome do portador do cartão

cvvCheckedboolean

Indica se o CVV foi verificado

fingerprintstring

Fingerprint único do cartão

first6digitsstring

Primeiros 6 dígitos do cartão

last4digitsstring

Últimos 4 dígitos do cartão

buyerIdstring uuid

UUID do comprador

expirationMonthstring

Mês de expiração

expirationYearstring

Ano de expiração

cardIdstring uuid

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