GET /api/transactions/external_id/:external_id - Buscar detalhes de uma transação pelo external_id.

:external_id

Busca os detalhes de uma transação pelo identificador externo (external_id). A transação retornada é sempre a do vendedor autenticado.

Headers

Nome	Obrigatório	Descrição
Authorization	Sim	`Bearer <token>`
User-Agent	Sim	Valor fornecido pelo gerente de contas

Parâmetros de path

Nome	Tipo	Descrição
external_id	String	Identificador externo da transação (o mesmo enviado na criação)

Exemplo de request

GET https://api.realtechdev.com.br/api/transactions/external_id/pedido-123

Resposta de sucesso (200 OK)

{
  "data": {
    "id": "07607ef4-a601-46d0-aca7-0887281853f1",
    "status": "paid",
    "payment_method": "pix",
    "total_amount": 3590,
    "net_amount": 3195.959,
    "created_at": "2025-05-24T16:43:25.625+00:00"
  }
}

Campo	Tipo	Descrição
id	String	UUID da transação
status	String	Ex.: `pending`, `paid`
payment_method	String	`pix`, `card` ou `boleto`
total_amount	Number	Valor total em centavos
net_amount	Number	Valor líquido
created_at	String	Data/hora em ISO 8601

Erros

401 Unauthorized

Token ausente ou inválido.

404 Not Found

Transação não encontrada para o external_id informado (ou pertence a outro vendedor):

{
  "error": {
    "message": "Transaction not found.",
    "detail": "Transaction not found."
  }
}

500 Internal Server Error

{
  "error": {
    "message": "Internal server error.",
    "detail": "Um erro inesperado ocorreu. Contate o suporte para mais informações."
  }
}

Consultar transação