Desativar cartão
Cartões
Desativar cartão
Desativa um cartão salvo — ele sai da listagem e deixa de poder ser cobrado.
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_.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
API Key da Credential (gerada no Backoffice)
Headers
Chave única para garantir idempotência da requisição
Response
Cartão desativado
ID do cartão (crd_).
Cliente dono do cartão (cust_).
Bandeira (ex.: visa, mastercard).
Seis primeiros dígitos.
Quatro últimos dígitos.
Nome impresso no cartão.
Mês de validade (MM).
Ano de validade (YYYY).
Situação do cartão.
Criação, ISO 8601.
Última alteração, ISO 8601.