> ## 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.
# Listar Cartões
> Retorna todos os cartões salvos do cliente, do mais recente para o mais antigo, no campo `data.cards`. O número completo (PAN) e o CVV nunca são retornados. Requer o header `account` com o código da conta.
Requer o header `account` com o código da conta. Retorna todos os cartões salvos do cliente, do mais recente para o mais antigo, no campo `data.cards`.
## OpenAPI
````yaml GET /v1/clients/{clientCode}/cards
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:
get:
tags:
- Cartões
summary: Listar cartões
description: >
Retorna todos os cartões salvos do cliente, do mais recente para o mais
antigo, no campo `data.cards`. O número completo (PAN) e o CVV nunca são
retornados. Requer o header `account` com o código da conta.
operationId: listClientCards
parameters:
- $ref: '#/components/parameters/AccountHeader'
- $ref: '#/components/parameters/ClientCode'
responses:
'200':
description: Lista de cartões retornada com sucesso
content:
application/json:
schema:
$ref: '#/components/schemas/CartaoListResponse'
example:
mensagem: Cartões listados com sucesso.
erro: false
mensagenserro: []
codigoretorno: 200
id: 00000000-0000-0000-0000-000000000000
data:
cards:
- id: 9b2f5c8e-3a1d-4f7b-8c6e-2d9a1b4c5e6f
card_token: 9b2f5c8e-3a1d-4f7b-8c6e-2d9a1b4c5e6f
first_six_digits: '542501'
last_four_digits: '8229'
brand: amex
holder_name: Tony Stark
exp_month: 1
exp_year: 2030
type: credit
status: active
tokenization_status: tokenized
created_at: '2026-03-28T22:09:43-03:00'
updated_at: '2026-03-28T22:09:43-03:00'
- id: 1a7d3f90-6b2c-4e18-9a5f-7c8e2d1b4a3c
card_token: 1a7d3f90-6b2c-4e18-9a5f-7c8e2d1b4a3c
first_six_digits: '411193'
last_four_digits: '6203'
brand: visa
holder_name: Tony Stark
exp_month: 1
exp_year: 2030
type: credit
status: active
tokenization_status: tokenized
created_at: '2026-03-29T22:09:43-03:00'
updated_at: '2026-03-29T22:09:43-03:00'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
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
schemas:
CartaoListResponse:
type: object
properties:
mensagem:
type: string
example: Cartões listados com sucesso.
erro:
type: boolean
example: false
mensagenserro:
type: array
items:
type: string
example: []
codigoretorno:
type: integer
example: 200
id:
type: string
example: 00000000-0000-0000-0000-000000000000
data:
type: object
properties:
cards:
type: array
items:
$ref: '#/components/schemas/CartaoData'
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'
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: []
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 `.
````