Skip to main content
DELETE
Excluir cartão
Requer o header account com o código da conta. A exclusão é um soft delete: o cartão passa a ter status deleted, com deleted_at preenchido, e seus tokens são removidos. Um evento card.deleted é emitido.
Um cartão vinculado a uma assinatura ativa não pode ser excluído — a API retorna 409 Conflict. Altere o cartão da assinatura antes de excluir.

Authorizations

Authorization
string
header
required

Token JWT obtido via POST /v1/login. Envie no header Authorization: Bearer <token>.

Headers

account
string
required

Código da conta à qual a operação se aplica

Example:

"acc_abc123xyz"

Path Parameters

clientCode
string
required

Código único do cliente dono do cartão

Example:

"cli_abc123"

cardId
string<uuid>
required

UUID do cartão

Example:

"9b2f5c8e-3a1d-4f7b-8c6e-2d9a1b4c5e6f"

Response

Cartão excluído com sucesso

mensagem
string
Example:

"Cartão recebido. A tokenização foi iniciada; o resultado será enviado por webhook."

erro
boolean
Example:

false

mensagenserro
string[]
Example:
codigoretorno
integer
Example:

201

id
string
Example:

"00000000-0000-0000-0000-000000000000"

data
object