Obtendo transações de criptomoedas por ID

Este endpoint permite obter os detalhes de uma transação específica pelo seu ID.

⚠️ IMPORTANTE - Regras Obrigatórias

🚨 AUTENTICAÇÃO: Todas as requisições DEVEM incluir um token JWT válido

📊 ID VÁLIDO: O ID da transação deve ser válido e existir no sistema

📍 Endpoint

GET https://api.etherglobalassets.com.br/criptobrokers/v1/transactions/{id}

🧾 Cabeçalhos obrigatórios (Headers)

Cabeçalho	Valor	Descrição
Authorization	Bearer <token>	Token JWT de autenticação

🧰 Parâmetros de Caminho (Path Parameters)

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
id	string	✅	ID da transação	`txn_123456789abcdef`

📌 Exemplo com curl

curl https://api.etherglobalassets.com.br/criptobrokers/v1/transactions/txn_123456789abcdef \
  --request GET \
  --header 'Authorization: Bearer <token>'

✅ Dica: Substitua <token> pelo seu JWT de autenticação válido e <id> pelo ID da transação.

✅ Resposta esperada (HTTP 200 - OK)

{
  "id": "txn_123456789abcdef",
  "walletId": "wallet_987654321fedcba",
  "typeAsset": "TOKEN",
  "type": "WITHDRAW",
  "amount": "1.250000000000000000",
  "externalRequestId": "req_123456789abcdef",
  "externalReferenceId": "ref_987654321fedcba",
  "senderAddress": "0xabcdef1234567890abcdef1234567890abcdef12",
  "recipientAddress": "0x1234567890abcdef1234567890abcdef12345678",
  "metadata": {},
  "symbol": "USDT",
  "tokenIdentifier": "0x1234567890abcdef1234567890abcdef12345678",
  "status": "PAID",
  "createdAt": "2024-01-15T10:30:00.000Z",
  "updatedAt": "2024-01-20T14:45:30.000Z"
}

Explicação da resposta:

Campo	Tipo	Descrição	Exemplo
id	string	ID único da transação	`"txn_123456789abcdef"`
walletId	string	ID da carteira	`"wallet_987654321fedcba"`
typeAsset	string	Tipo do ativo	`"TOKEN"`
type	string	Tipo da transação	`"WITHDRAW"`
amount	string	Quantidade da transação	`"1.250000000000000000"`
externalRequestId	string	ID da requisição externa	`"req_123456789abcdef"`
externalReferenceId	string	ID da referência externa	`"ref_987654321fedcba"`
senderAddress	string	Endereço do remetente	`"0xabcdef1234567890abcdef1234567890abcdef12"`
recipientAddress	string	Endereço do destinatário	`"0x1234567890abcdef1234567890abcdef12345678"`
metadata	object	Metadados da transação	`{}`
symbol	string	Símbolo do ativo	`"USDT"`
tokenIdentifier	string	Identificador do token	`"0x1234567890abcdef1234567890abcdef12345678"`
status	string	Status da transação	`"PAID"`
createdAt	string	Data de criação	`"2024-01-15T10:30:00.000Z"`
updatedAt	string	Data de atualização	`"2024-01-20T14:45:30.000Z"`

⚠️ Possíveis erros

Código	Erro	Causa comum
400	Bad Request	ID da transação inválido
401	Unauthorized	Token inválido ou ausente
500	Internal Server Error	Erro interno do serviço

🎯 Como usar a consulta de transação por ID

Após receber a resposta, você pode:

Verificar status: Use status para verificar o estado da transação
Analisar tipo: Use type e typeAsset para categorizar a transação
Verificar valores: Use amount para análises financeiras
Rastrear transação: Use externalRequestId e externalReferenceId para rastreamento
Verificar endereços: Use senderAddress e recipientAddress para verificar direções

🛡️ Limitações e restrições

✅ FAÇA:

Sempre use autenticação válida
Use IDs válidos de transação
Verifique o status da transação
Analise todos os campos retornados
Confirme os valores antes de usar

❌ NÃO FAÇA:

Ignorar a autenticação
Usar IDs inválidos
Ignorar o status da transação
Assumir valores sem verificar

🆘 Problemas comuns

“Estou recebendo erro 400!”

Verifique se o ID da transação é válido
Confirme se o token é válido
Verifique se a transação existe no sistema

“Erro 401!”

Verifique se o token de autenticação é válido
Faça uma nova autenticação se necessário

“Transação não encontrada!”

Verifique se o ID está correto
Confirme se a transação existe
Verifique se você tem permissão para acessar

📞 Suporte

Se nada funcionar:

Verifique se o ID da transação é válido
Confirme se o token de autenticação é válido
Verifique se a transação existe no sistema
Entre em contato com nossa equipe de suporte

Mais informações sobre o endpoint:

Acesse aqui