Consultar Cash In por ID

Consulta o status e detalhes de uma transacao PIX pelo ID da transacao.

Endpoint

GET /api/v2/external/transactions/:id

Headers

Header	Tipo	Obrigatorio	Descricao
Authorization	String	Sim	Bearer {access_token}

Path Parameters

Parametro	Tipo	Obrigatorio	Descricao
id	String	Sim	ID da transacao (transaction_id)

Exemplo

curl -X GET https://api.owem.com.br/api/v2/external/transactions/PIXIN20260307a1b2c3d4e5f6 \
  -H "Authorization: Bearer $TOKEN"

Resposta de Sucesso (200)

{
  "worked": true,
  "data": {
    "id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
    "transaction_id": "PIXIN20260307a1b2c3d4e5f6",
    "end_to_end_id": "E37839059202603071530000001",
    "type": "pix",
    "status": "completed",
    "amount": 10000,
    "fee_amount": 0,
    "net_amount": 10000,
    "description": "Pedido #1234",
    "direction": "inbound",
    "counterparty_name": "Maria Santos",
    "created_at": "2026-03-07T15:30:00Z",
    "completed_at": "2026-03-07T15:30:02Z"
  }
}

Campo	Tipo	Descricao
worked	Boolean	true indica sucesso na operacao
data.id	String	UUID interno da transacao
data.transaction_id	String	Identificador publico da transacao
data.end_to_end_id	String	ID ponta-a-ponta do BACEN (E2E)
data.type	String	Tipo da transacao (pix)
data.status	String	Status atual (veja tabela abaixo)
data.amount	Integer	Valor em centavos
data.fee_amount	Integer	Valor da tarifa em centavos
data.net_amount	Integer	Valor liquido em centavos
data.description	String	Descricao da transacao
data.direction	String	inbound para recebimentos
data.counterparty_name	String	Nome do pagador
data.created_at	String	Data de criacao (ISO 8601)
data.completed_at	String	Data de conclusao (ISO 8601), null se pendente

Status Possiveis

Status	Descricao
pending	Aguardando pagamento
processing	Pagamento em processamento
completed	Pagamento confirmado
failed	Pagamento falhou
cancelled	Cobranca cancelada ou expirada

Resposta de Erro (404)

{
  "worked": false,
  "detail": "Transacao nao encontrada"
}

Resposta de Erro (401)

{
  "worked": false,
  "detail": "Token invalido ou expirado"
}

Polling vs Webhook

Para acompanhar o status de uma cobranca, prefira utilizar Webhooks em vez de polling. Caso precise consultar, use intervalos de no minimo 5 segundos.