Skip to main content
GET
Consultar cartão
Use esta rota para acompanhar o tokenization_status depois de salvar o cartão.
O id precisa ser o UUID do cartão. Um cartão de outra conta, ou inexistente, retorna 404 (resource_missing).
A resposta nunca traz o número completo do cartão nem o código de segurança.

Authorizations

Authorization
string
header
required

Chave de API (secret key) da conta, no formato sk_live_... (produção) ou sk_test_... (Dev mode). Envie no header Authorization: Bearer <chave>. Autentica todas as rotas da API v2 e as rotas de Análise de Fraude. A chave identifica a conta, então a API v2 não usa o header account. Uma chave só é aceita no ambiente em que foi criada. Gere a sua no dashboard em Configurações → Chaves de API.

Path Parameters

id
string
required

Identificador do recurso (o campo id devolvido pela API)

Response

Cartão encontrado

Cartão salvo. O número completo e o código de segurança nunca são devolvidos

id
string<uuid>

Use este valor como card.token em pedidos, assinaturas e faturas

Example:

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

object
enum<string>
Available options:
card
brand
string
Example:

"visa"

first_six
string
Example:

"411111"

last_four
string
Example:

"1111"

holder_name
string
Example:

"João Silva"

exp_month
integer
Example:

12

exp_year
integer
Example:

2030

type
enum<string> | null
Available options:
credit,
debit
tokenization_status
enum<string>

pending: tokenização em andamento. tokenized: concluída. failed: nenhuma adquirente conseguiu tokenizar. Um cartão com failed ainda pode ser usado em compras.

Available options:
pending,
tokenized,
failed
customer
object
created_at
string
Example:

"2026-09-14T12:00:00-03:00"