---
title: "Recuperar Card Tokens"
method: GET
path: "/payment/v1/cards/{buyerUuid}"
tags: ["Recuperação de Card Tokens"]
---

# Recuperar Card Tokens

`GET /payment/v1/cards/{buyerUuid}`

## Request

- Base URL: `https://api.barte.com`
- URL: `https://api.barte.com/payment/v1/cards/{buyerUuid}`
- Auth: API key in header `X-Token-Api`
- TypeScript: <https://skmtc.dev/barte/apis/api-de-sellers-v2-atualizada/docs/payment/v1/cards/:buyerUuid/get.ts> (a function with typed inputs; its response is checked against the schema)

Retorna todos os tokens de cartão associados a um comprador específico. Útil para listar cartões salvos do cliente.

## Path parameters

- `buyerUuid` string, uuid, required

## Response `200`

Lista de tokens de cartão recuperada com sucesso

- CardTokenListResponse[]
  - `uuid` string, uuid: UUID do token
  - `status` 'ACTIVE' | 'PENDING' | 'INACTIVE': Status do token
  - `createdAt` string, date: Data de criação
  - `brand` 'visa' | 'mastercard' | 'elo' | 'american_express' | 'hipercard' | 'diners': Bandeira do cartão
  - `first6digits` string: Primeiros 6 dígitos
  - `last4digits` string: Últimos 4 dígitos
  - `buyerId` string, uuid: UUID do comprador
  - `expirationMonth` string: Mês de expiração
  - `expirationYear` string: Ano de expiração
  - `cardId` string, uuid: ID do cartão para uso em pagamentos

## Other responses

- `400`: Requisição inválida
- `401`: Não autorizado
- `403`: Acesso proibido
- `500`: Erro interno do servidor

---

[API](https://skmtc.dev/barte/apis/api-de-sellers-v2-atualizada.md) - [All operations](https://skmtc.dev/barte/apis/api-de-sellers-v2-atualizada/llms.txt) - [OpenAPI document](https://skmtc.dev/barte/apis/api-de-sellers-v2-atualizada/revisions/f0dd55b167f1?raw)