> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superpagamentos.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Recuperar dados do cartão tokenizado

> Busca os dados de um cartão tokenizado específico. Esta rota retorna informações parciais do cartão (apenas os primeiros e últimos 4 dígitos) por questões de segurança, mantendo os dados sensíveis protegidos.

**Importante:**
- Apenas os primeiros e últimos 4 dígitos do cartão são retornados
- Os dados completos do cartão nunca são expostos na API
- O cartão só pode ser consultado se pertencer ao cliente associado



## OpenAPI

````yaml GET /cards/{tokenizedCardId}
openapi: 3.1.0
info:
  title: OpenAPI Super APIs
  description: Documentação das APIs destinada a companhias da Super Pagamentos
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://sandbox-api.superpagamentos.com
    description: Ambiente de desenvolvimento
  - url: https://api.superpagamentos.com
    description: Ambiente de produção
security: []
paths:
  /cards/{tokenizedCardId}:
    get:
      description: >-
        Busca os dados de um cartão tokenizado específico. Esta rota retorna
        informações parciais do cartão (apenas os primeiros e últimos 4 dígitos)
        por questões de segurança, mantendo os dados sensíveis protegidos.


        **Importante:**

        - Apenas os primeiros e últimos 4 dígitos do cartão são retornados

        - Os dados completos do cartão nunca são expostos na API

        - O cartão só pode ser consultado se pertencer ao cliente associado
      parameters:
        - name: tokenizedCardId
          in: path
          description: Identificador único do token do cartão
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Cartão encontrado com sucesso
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                        format: uuid
                        description: Identificador único do token do cartão
                        example: 6941e55c-4e66-47c9-b698-c116f4005258
                      customerId:
                        type: string
                        format: uuid
                        description: >-
                          Identificador único do cliente ao qual o cartão está
                          associado
                        example: 9e6ce99e-0ad5-4e38-b5af-ae44160e8fda
                      holderName:
                        type: string
                        description: Nome do titular do cartão
                        example: João Silva
                      first4Digits:
                        type: string
                        description: Primeiros 4 dígitos do cartão
                        example: '0000'
                      last4Digits:
                        type: string
                        description: Últimos 4 dígitos do cartão
                        example: '0000'
                      expirationMonth:
                        type: string
                        description: Mês de expiração do cartão
                        example: '10'
                      expirationYear:
                        type: string
                        description: Ano de expiração do cartão
                        example: '2031'
                      cardBrand:
                        type: string
                        description: Bandeira do cartão
                        example: MasterCard
                      isActive:
                        type: boolean
                        description: Indica se o cartão está ativo
                        example: true
                      isVerified:
                        type: boolean
                        description: Indica se o cartão foi verificado
                        example: false
                      postalCodeCheck:
                        type: boolean
                        description: Indica se o CEP do cartão foi verificado
                        example: false
                      securityCodeCheck:
                        type: boolean
                        description: >-
                          Indica se o código de segurança do cartão foi
                          verificado
                        example: false
                      addressCheck:
                        type: boolean
                        description: Indica se o endereço do cartão foi verificado
                        example: false
                      createdAt:
                        type: string
                        format: date-time
                        description: Data e hora em que o cartão foi tokenizado
                        example: '2025-06-02T17:51:28.958Z'
                  message:
                    type: string
                    example: Cartão encontrado com sucesso
        '400':
          description: Erro ao buscar cartão
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      message:
                        type: string
                      returnCode:
                        type: integer
              examples:
                Cartão não encontrado:
                  value:
                    data:
                      message: Cartão não encontrado
                      returnCode: -7508
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Token JWT gerado na rota de autenticação (/auth). Deve ser enviado no
        formato: Bearer <token>

````