Skip to main content
GET
/
api
/
v1
/
customers
/
{identifier}
Buscar Cliente
curl --request GET \
  --url https://zeus-sandbox.autorizou.dev/api/v1/customers/{identifier} \
  --header 'Authorization: Bearer <token>'
Este endpoint permite recuperar as informações de um cliente específico usando seu ID único ou email.

​
Casos de Uso

  • 🔍 Consulta de dados do cliente para exibição
  • ✅ Validação antes de processar pagamentos
  • 📋 Recuperação de informações para formulários
  • 🔄 Sincronização de dados entre sistemas

​
Parâmetros de URL

​
identifier
string
required
Identificador do cliente. Pode ser UUID, email ou hash do cliente
  • UUID do cliente (ex: 142465c6-4c9d-4fd1-9632-2c40af316da3)
  • Email do cliente (ex: maria@exemplo.com.br)
  • Hash do cliente (ex: AUTCUS01K8RSCH3T5FNB7EVACV8DQVNX)

​
Exemplos de Requisição

​
Buscar por UUID

curl -X GET https://zeus-sandbox.autorizou.dev/api/v1/customers/142465c6-4c9d-4fd1-9632-2c40af316da3 \
  -H "Authorization: Bearer 4eC39HqLyjWDarjtT1zdp7dc"

​
Buscar por Email

curl -X GET "https://zeus-sandbox.autorizou.dev/api/v1/customers/maria@exemplo.com.br" \
  -H "Authorization: Bearer 4eC39HqLyjWDarjtT1zdp7dc"

​
Buscar por Hash

curl -X GET "https://zeus-sandbox.autorizou.dev/api/v1/customers/AUTCUS01K8RSCH3T5FNB7EVACV8DQVNX" \
  -H "Authorization: Bearer 4eC39HqLyjWDarjtT1zdp7dc"

​
Resposta de Sucesso

{
  "id": "142465c6-4c9d-4fd1-9632-2c40af316da3",
  "hash": "AUTCUS01K8RSCH3T5FNB7EVACV8DQVNX",
  "name": "Maria da Silva Santos",
  "email": "maria.santos@exemplo.com.br",
  "created_at": "29/10/2025 17:08:42",
  "updated_at": "29/10/2025 17:08:42"
}

​
Códigos de Erro

Cliente não encontrado
{
   "message": "Cliente não encontrado."
}
Possíveis causas:
  • UUID, email ou hash não existe
  • Cliente pertence a outro merchant
  • Identificador malformado
Parâmetro de identificação inválido
{
  "message": "Identificador do cliente é inválido"
}

​
Detalhes da Resposta

​
Campos Principais

CampoTipoDescrição
idstringUUID único do cliente
hashstringHash do cliente
namestringNome completo do cliente
emailstringEmail do cliente
created_atstringData de criação
updated_atstringData da última atualização

​
Considerações de Performance

Cache recomendado: As informações do cliente mudam raramente. Considere implementar cache local com TTL de 1 hora para melhorar a performance.
Rate limiting: Este endpoint está sujeito aos limites de requisições por minuto do seu plano.

​
Próximos Passos

Após recuperar os dados do cliente:
  1. Processar um pagamento
  2. Criar um novo cartão