Consultar Cash In por Tag

Consulta transacciones PIX que corresponden a una tag (prefijo del transaction_id).

Endpoint

GET /api/external/transactions/tag/:tag

Headers

Header	Tipo	Obligatorio	Descripcion
Authorization	String	Si	ApiKey {client_id}:{client_secret}

Path Parameters

Parametro	Tipo	Obligatorio	Descripcion
tag	String	Si	Prefijo del transaction_id para busqueda

Prefijos de Tag

Los transaction_id siguen el patron PIXIN (cobros) y PIXOUT (envios) seguido de la fecha. Use PIXIN20260307 para buscar todos los cobros del 07/03/2026.

Ejemplo

curl -X GET https://api.owem.com.br/api/external/transactions/tag/PIXIN20260307 \
  -H "Authorization: ApiKey $CLIENT_ID:$CLIENT_SECRET"

Respuesta de Exito (200)

{
  "worked": true,
  "data": [
    {
      "id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
      "transaction_id": "7popu57v6us7p6pcicgq12345",
      "end_to_end_id": "E37839059202603071530000001",
      "external_id": "order-9876",
      "type": "pix",
      "status": "completed",
      "amount": 300000,
      "fee_amount": 0,
      "net_amount": 300000,
      "direction": "inbound",
      "counterparty_name": "Maria Santos",
      "created_at": "2026-03-07T15:30:00Z",
      "completed_at": "2026-03-07T15:30:02Z"
    },
    {
      "id": "f7e8d9c0-b1a2-4c3d-9e8f-7a6b5c4d3e2f",
      "transaction_id": "7popu57v6us7p6pcicgq67890",
      "end_to_end_id": "E37839059202603071545000002",
      "external_id": null,
      "type": "pix",
      "status": "completed",
      "amount": 2500000,
      "fee_amount": 0,
      "net_amount": 2500000,
      "direction": "inbound",
      "counterparty_name": "Joao Silva",
      "created_at": "2026-03-07T15:45:00Z",
      "completed_at": "2026-03-07T15:45:03Z"
    }
  ]
}

Campo	Tipo	Descripcion
worked	Boolean	true indica exito en la operacion
data	Array	Lista de transacciones que corresponden a la tag

Cada objeto en el array sigue la misma estructura descrita en Consultar por ID. Valores monetarios en unidades base (/ 10.000 para reales).

Respuesta de Exito -- Sin Resultados (200)

{
  "worked": true,
  "data": []
}

Respuesta de Error (401)

{
  "error": {
    "status": 401,
    "message": "Missing API key credentials. Use Authorization: ApiKey <client_id>:<client_secret>"
  }
}

Cash In y Cash Out

Este endpoint retorna tanto transacciones de entrada como de salida que correspondan a la tag. Filtre por el prefijo PIXIN para obtener solo cobros o PIXOUT para solo envios.