Cartoes
Consultar Cartão
Consulta os dados de um cartão pelo seu token
Consultar cartão
GET /api/v1/cards/{tokenCard}Retorna os dados de um cartão tokenizado a partir do seu token.
Requer autenticação Bearer. Veja Autenticação.
Request
Parâmetros de rota
| Parâmetro | Tipo | Obrigatório | Exemplo |
|---|---|---|---|
tokenCard | string | sim | a1b2c3d4-e5f6-4789-9abc-def012345678 |
Response
200 OK
{
"codigoResposta": "0",
"mensagemResposta": "Consulta realizada com sucesso",
"cartoes": [
{
"statusCard": "ATV",
"bandeiraCartao": "1",
"token": "a1b2c3d4-e5f6-4789-9abc-def012345678",
"bin": "411111",
"suffix": "1111",
"dataExpiracao": "12/28",
"customerId": "CLI-000123",
"dataCriacao": "2026-08-01T14:30:00",
"dataModificacao": "2026-08-01T14:30:00"
}
],
"paginaAtual": "1",
"totalPaginas": "1",
"quantidade": "1"
}Campos da resposta
| Campo | Tipo | Descrição |
|---|---|---|
codigoResposta | string | Código de resposta da consulta |
mensagemResposta | string | Mensagem de resposta da consulta |
cartoes | array | Lista de cartões encontrados (objeto Cartao) |
paginaAtual | string | Página atual do resultado |
totalPaginas | string | Total de páginas |
quantidade | string | Quantidade de cartões retornados |
Campos de cartoes[]
| Campo | Tipo | Descrição |
|---|---|---|
statusCard | enum | ATV ativo, INA inativo |
bandeiraCartao | string | Código da bandeira |
token | string | Token do cartão |
bin | string | BIN do cartão |
suffix | string | Últimos 4 dígitos |
dataExpiracao | string | Validade MM/AA |
customerId | string | Identificador do cliente |
dataCriacao | string | Data de criação |
dataModificacao | string | Data da última modificação |
Erros
| Status | Significado |
|---|---|
404 | Cartão não encontrado para o token informado |
500 | Erro interno ao consultar o cartão |