Skip to main content
DELETE
Desativar cartão
DELETE /customers/{customerId}/cards/{cardId} Faz parte do recurso Cartões — como um cartão é salvo e como cobrá-lo estão lá. Desativa o cartão. Ele sai da listagem, o GET por ID passa a responder 404 e o crd_ deixa de servir para cobrar.
A resposta é a última vez que você vê o cartão, e ela vem com status: "disabled". Se você registra a desativação do seu lado, é daqui que o dado sai — depois desta chamada, nenhuma rota devolve esse crd_.
Não há rota de reativação — mas salvar o mesmo cartão o reativa. Se o cliente informar o mesmo cartão de novo (um token novo do Tokenizer, mesmos dados), a impressão digital casa com o registro desativado e ele volta ativo, com o mesmo crd_. Cartão diferente gera um crd_ novo. Trate a desativação como “parar de cobrar”, não como apagar: o reenvio do próprio cartão pelo cliente desfaz.
O histórico não muda. Transações e pagamentos feitos com aquele cartão continuam existindo e guardam os dados usados na cobrança. Desativar é sobre o uso futuro, não sobre o passado.
Endpoint idempotente. Envie o header Idempotency-Key — desativar duas vezes por um retry não é problema, mas a segunda chamada sem a chave responderia 404, já que o cartão não é mais encontrado.

Authorizations

x-api-key
string
header
required

API Key da Credential (gerada no Backoffice)

Headers

Idempotency-Key
string

Chave única para garantir idempotência da requisição

Path Parameters

cardId
string
required

ID do cartão

customerId
string
required

ID do cliente

Response

Cartão desativado

id
string

ID do cartão (crd_).

customerId
string

Cliente dono do cartão (cust_).

brand
string

Bandeira (ex.: visa, mastercard).

firstDigits
string

Seis primeiros dígitos.

lastDigits
string

Quatro últimos dígitos.

holderName
string

Nome impresso no cartão.

expirationMonth
string

Mês de validade (MM).

expirationYear
string

Ano de validade (YYYY).

status
string

Situação do cartão.

createdAt
string

Criação, ISO 8601.

updatedAt
string

Última alteração, ISO 8601.