Listando chaves PIX

Este endpoint permite listar todas as chaves PIX do usuário autenticado.

📍 Endpoint

GET https://api.etherglobalassets.com.br/pix/keys

🧾 Cabeçalhos obrigatórios (Headers)

📌 Exemplo com curl

curl https://api.etherglobalassets.com.br/pix/keys \
  --request GET \
  --header 'Authorization: Bearer <token>'

✅ Dica: Substitua <token> pelo seu JWT de autenticação válido.

✅ Resposta esperada (HTTP 200 - OK)

[
  {
    "id": "uuid-12345678-1234-1234-1234-123456789012",
    "pixKey": "12345678901",
    "pixKeyType": "CPF",
    "createdAt": "2025-01-31T10:00:00Z",
    "isActive": true,
    "bankName": "BCO SANTANDER (BRASIL) S.A."
  },
  {
    "id": "uuid-87654321-4321-4321-4321-210987654321",
    "pixKey": "usuario@exemplo.com",
    "pixKeyType": "EMAIL",
    "createdAt": "2025-01-30T15:30:00Z",
    "isActive": true,
    "bankName": "BANCO DO BRASIL S.A."
  }
]

Explicação da resposta:

Tipos de Chave PIX:

⚠️ Possíveis erros

🎯 Como usar as chaves PIX

Após receber a resposta, você pode:

1. Listar chaves: Use o array para mostrar todas as chaves disponíveis

2. Verificar status: Use isActive para verificar se a chave está ativa

3. Identificar tipos: Use pixKeyType para diferenciar os tipos de chave

4. Validar bancos: Use bankName para identificar a instituição bancária

5. Rastrear criação: Use createdAt para ver quando a chave foi criada

🛡️ Limitações e restrições

✅ FAÇA:

• Use o campo isActive para verificar chaves ativas

• Verifique o pixKeyType antes de usar a chave

• Considere o bankName para identificação da instituição

• Use o id para referenciar chaves específicas

❌ NÃO FAÇA:

• Ignorar o status isActive das chaves

• Usar chaves inativas para transações

• Assumir que todas as chaves são do mesmo tipo

• Expor dados sensíveis das chaves PIX

🆘 Problemas comuns

“Estou recebendo erro 401!”

• Verifique se o token de autenticação é válido

• Faça uma nova autenticação se necessário

“A lista está vazia!”

• Verifique se o usuário tem chaves PIX cadastradas

• Confirme se as chaves não foram deletadas

“Algumas chaves não aparecem!”

• Verifique se as chaves estão com isActive: true

• Confirme se não há filtros aplicados

📞 Suporte

Se nada funcionar:

1. Verifique a autenticação está válida

2. Confirme se há chaves cadastradas

3. Entre em contato com nossa equipe de suporte

Mais informações sobre o endpoint: