Consultar Cash Out por ID

Consulta os detalhes e o status de uma transação PIX pelo transaction_id.

Endpoint

GET /api/v2/external/transactions/{id}

Headers

Header	Tipo	Obrigatório	Descrição
Authorization	String	Sim	Bearer {access_token}

Path Parameters

Parâmetro	Tipo	Obrigatório	Descrição
id	String	Sim	ID da transação (transaction_id)

Exemplo

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

Resposta de Sucesso — 200

{
  "worked": true,
  "data": {
    "id": "c7f3a8b1-2d4e-4f6a-9c1b-3e5f7a9b1d3e",
    "transaction_id": "PIXOUT20260309a1b2c3d4e5f6",
    "end_to_end_id": "E37839059202603091530abcdef01",
    "type": "pix",
    "direction": "outbound",
    "status": "completed",
    "amount": 10000,
    "fee": 0,
    "description": "Pagamento fornecedor",
    "payer": {
      "name": "Empresa Exemplo LTDA",
      "document": "12345678000199",
      "ispb": "37839059",
      "account": "100001"
    },
    "payee": {
      "name": "Joao Silva",
      "document": "***456789**",
      "ispb": "00000000",
      "account": "987654"
    },
    "created_at": "2026-03-09T15:30:00Z",
    "updated_at": "2026-03-09T15:30:02Z"
  }
}

Campos da Resposta

Campo	Tipo	Descrição
data.id	String	UUID interno da transação
data.transaction_id	String	Identificador único da transação
data.end_to_end_id	String	Identificador End-to-End no SPI/BACEN
data.type	String	Tipo da transação (pix)
data.direction	String	Direção: outbound (cash-out) ou inbound (cash-in)
data.status	String	Status atual (ver tabela abaixo)
data.amount	Integer	Valor em centavos
data.fee	Integer	Tarifa cobrada em centavos
data.description	String	Descrição informada na criação
data.payer	Object	Dados do pagador
data.payer.name	String	Nome do pagador
data.payer.document	String	CPF/CNPJ do pagador
data.payer.ispb	String	ISPB da instituição do pagador
data.payer.account	String	Conta do pagador
data.payee	Object	Dados do recebedor
data.payee.name	String	Nome do recebedor
data.payee.document	String	CPF/CNPJ do recebedor (mascarado)
data.payee.ispb	String	ISPB da instituição do recebedor
data.payee.account	String	Conta do recebedor
data.created_at	String	Data de criação (ISO 8601)
data.updated_at	String	Data da última atualização (ISO 8601)

Status da Transação

Status	Descrição
pending_approval	Aguardando aprovação (fluxo criar + aprovar)
processing	Enviada ao SPI, aguardando liquidação
completed	Liquidada com sucesso
failed	Rejeitada pelo SPI ou erro no processamento
refunded	Devolvida (total ou parcial)

Resposta de Erro — 404

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