> ## Documentation Index
> Fetch the complete documentation index at: https://docs.4seletpay.com.br/llms.txt
> Use this file to discover all available pages before exploring further.
# Excluir Cartão
> Remove um cartão (soft delete): o registro passa a ter `status` `deleted` com `deleted_at` preenchido, e seus tokens são removidos. Um cartão vinculado a uma assinatura ativa não pode ser excluído (retorna `409 Conflict`). Um evento `card.deleted` é emitido. Requer o header `account` com o código da conta.
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.
## OpenAPI
````yaml DELETE /v1/clients/{clientCode}/cards/{cardId}
openapi: 3.1.0
info:
title: 4Selet Pay API
description: >
API de processamento de pagamentos da plataforma 4Selet Pay. Suporta
cobranças únicas, assinaturas recorrentes, PIX, Cartão de Crédito. Todas as
rotas autenticadas requerem um Bearer Token obtido via `/v1/login`.
version: 1.0.0
contact:
name: 4Selet Pay
email: suporte@4selet.com.br
servers:
- url: https://sandbox.4seletpay.com.br/api
description: Servidor de Sandbox
security:
- bearerAuth: []
tags:
- name: Autenticação
description: Rotas de autenticação e criação de usuários
- name: Cobranças
description: Criação, consulta, cancelamento e reembolso de cobranças
- name: Pedidos
description: Consulta de pedidos e gerenciamento de confirmações desafiadas
- name: Cartões
description: Cadastro e gerenciamento dos cartões salvos de um cliente
- name: Assinaturas
description: Criação e gerenciamento de assinaturas recorrentes
- name: Faturas
description: Gerenciamento de faturas e pagamento de faturas em atraso
- name: Clientes Bloqueados
description: Gerenciamento de lista negra de clientes
- name: Contas
description: Criação e gerenciamento de contas na plataforma
- name: Aplicativo
description: Endpoints para dashboard e uso via aplicativo mobile
- name: Notificações Push
description: Envio e gerenciamento de notificações push
- name: Utilitários
description: Endpoints utilitários como listagem de fusos horários
- name: Gestão
description: Relatórios gerenciais (acesso restrito a Super Admins)
- name: Webhooks
description: Endpoints para receber notificações de gateways de pagamento
- name: Endpoints de Webhook
description: >-
Gerenciamento de endpoints de webhook para receber notificações de eventos
da plataforma
- name: Links de Pagamento
description: Criação e gerenciamento de links de pagamento com checkout pré-configurado
- name: Análise de Fraude
description: >-
API de Risco — consulta o risco de fraude de uma transação (autenticada
por chave de API)
paths:
/v1/clients/{clientCode}/cards/{cardId}:
delete:
tags:
- Cartões
summary: Excluir cartão
description: >
Remove um cartão (soft delete): o registro passa a ter `status`
`deleted` com `deleted_at` preenchido, e seus tokens são removidos. Um
cartão vinculado a uma assinatura ativa não pode ser excluído (retorna
`409 Conflict`). Um evento `card.deleted` é emitido. Requer o header
`account` com o código da conta.
operationId: deleteClientCard
parameters:
- $ref: '#/components/parameters/AccountHeader'
- $ref: '#/components/parameters/ClientCode'
- $ref: '#/components/parameters/CardId'
responses:
'200':
description: Cartão excluído com sucesso
content:
application/json:
schema:
$ref: '#/components/schemas/CartaoResponse'
example:
mensagem: Cartão removido com sucesso.
erro: false
mensagenserro: []
codigoretorno: 200
id: 00000000-0000-0000-0000-000000000000
data:
id: 9b2f5c8e-3a1d-4f7b-8c6e-2d9a1b4c5e6f
card_token: 9b2f5c8e-3a1d-4f7b-8c6e-2d9a1b4c5e6f
first_six_digits: '542501'
last_four_digits: '7793'
brand: mastercard
holder_name: Tony Stark
exp_month: 1
exp_year: 2030
type: credit
status: deleted
tokenization_status: tokenized
created_at: '2026-04-04T12:43:16-03:00'
updated_at: '2026-04-04T12:43:30-03:00'
deleted_at: '2026-04-04T12:43:30-03:00'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
'409':
description: Cartão vinculado a uma assinatura ativa
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
mensagem: Não foi possível remover o cartão.
erro: true
mensagenserro:
- >-
Este cartão está vinculado a uma assinatura ativa e não pode
ser removido. Altere o cartão da assinatura primeiro.
codigoretorno: 409
id: 00000000-0000-0000-0000-000000000000
data: []
security:
- bearerAuth: []
components:
parameters:
AccountHeader:
name: account
in: header
required: true
description: Código da conta à qual a operação se aplica
schema:
type: string
example: acc_abc123xyz
ClientCode:
name: clientCode
in: path
required: true
description: Código único do cliente dono do cartão
schema:
type: string
example: cli_abc123
CardId:
name: cardId
in: path
required: true
description: UUID do cartão
schema:
type: string
format: uuid
example: 9b2f5c8e-3a1d-4f7b-8c6e-2d9a1b4c5e6f
schemas:
CartaoResponse:
type: object
properties:
mensagem:
type: string
example: >-
Cartão recebido. A tokenização foi iniciada; o resultado será
enviado por webhook.
erro:
type: boolean
example: false
mensagenserro:
type: array
items:
type: string
example: []
codigoretorno:
type: integer
example: 201
id:
type: string
example: 00000000-0000-0000-0000-000000000000
data:
$ref: '#/components/schemas/CartaoData'
ErrorResponse:
type: object
properties:
mensagem:
type: string
example: Um erro inesperado acabou de acontecer.
erro:
type: boolean
example: true
mensagenserro:
type: array
items:
type: string
example:
- Detalhe do erro ocorrido.
codigoretorno:
type: integer
example: 400
id:
type: string
example: 00000000-0000-0000-0000-000000000000
data:
type: array
example: []
CartaoData:
type: object
properties:
id:
type: string
format: uuid
description: UUID identificador do cartão
example: 9b2f5c8e-3a1d-4f7b-8c6e-2d9a1b4c5e6f
card_token:
type: string
description: >
Identificador do cartão salvo, retornado ao salvar o cartão e no
evento `card.token_created`. É o valor enviado em
`payment.card.card_token` ao cobrar com o cartão salvo.
example: 9b2f5c8e-3a1d-4f7b-8c6e-2d9a1b4c5e6f
first_six_digits:
type: string
nullable: true
description: Seis primeiros dígitos do cartão (BIN)
example: '542501'
last_four_digits:
type: string
nullable: true
description: Quatro últimos dígitos do cartão
example: '7793'
brand:
type: string
description: Bandeira do cartão
enum:
- visa
- mastercard
- elo
- amex
- undefined
example: mastercard
holder_name:
type: string
description: Nome do portador impresso no cartão
example: Tony Stark
exp_month:
type: integer
nullable: true
description: Mês de validade (1–12)
example: 1
exp_year:
type: integer
nullable: true
description: Ano de validade (YYYY)
example: 2030
type:
type: string
description: Tipo do cartão
enum:
- credit
- debit
example: credit
status:
type: string
description: Situação do cartão
enum:
- active
- deleted
example: active
tokenization_status:
type: string
description: >
Situação da tokenização do cartão. `pending` enquanto está sendo
processado, `tokenized` quando o cartão está pronto para cobranças e
`failed` quando não foi possível tokenizá-lo. As transições
`tokenized`/`failed` também são notificadas por webhook
(`card.token_created` / `card.token_failed`).
enum:
- pending
- tokenized
- failed
example: pending
created_at:
type: string
format: date-time
description: Data de criação (ISO 8601)
example: '2026-05-27T10:00:00-03:00'
updated_at:
type: string
format: date-time
description: Data da última atualização (ISO 8601)
example: '2026-05-27T10:00:00-03:00'
deleted_at:
type: string
format: date-time
nullable: true
description: Data de exclusão (ISO 8601) — presente apenas em cartão excluído
example: '2026-04-04T12:43:30-03:00'
responses:
Unauthorized:
description: Não autorizado — token inválido ou ausente
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
mensagem: Unauthenticated.
erro: true
mensagenserro: []
codigoretorno: 401
id: 00000000-0000-0000-0000-000000000000
data: []
NotFound:
description: Recurso não encontrado
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
mensagem: The charge code does not match any charge
erro: true
mensagenserro: []
codigoretorno: 404
id: 00000000-0000-0000-0000-000000000000
data: []
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: >-
Token JWT obtido via `POST /v1/login`. Envie no header `Authorization:
Bearer `.
````