Consultar Cash Out por Tag

Consulta transacciones PIX que corresponden a una tag (prefijo del transaction_id). Permite agrupar y buscar transacciones por fecha, tipo o cualquier prefijo del identificador.

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

Ejemplos de busqueda por tag

• PIXOUT20260309 -- todas las transferencias PIX de salida del dia 09/03/2026
• PIXOUT -- todas las transferencias PIX de salida
• PIXIN20260309 -- todos los cobros PIX del dia 09/03/2026

Ejemplo

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

Respuesta de Exito -- 200

{
  "worked": true,
  "data": [
    {
      "id": "c7f3a8b1-2d4e-4f6a-9c1b-3e5f7a9b1d3e",
      "transaction_id": "PIXOUT20260309a1b2c3d4e5f6",
      "end_to_end_id": "E37839059202603091530abcdef01",
      "external_id": "order-9876",
      "type": "pix",
      "direction": "outbound",
      "status": "completed",
      "amount": 300000,
      "fee_amount": 350,
      "net_amount": 300350,
      "description": "Pagamento fornecedor",
      "counterparty_name": "Joao Silva",
      "recipient_key": "12345678901",
      "created_at": "2026-03-09T15:30:00Z",
      "completed_at": "2026-03-09T15:30:02Z"
    },
    {
      "id": "d8e4b9c2-3f5a-5b7c-0d2e-4f6a8b0c2e4f",
      "transaction_id": "PIXOUT20260309f6e5d4c3b2a1",
      "end_to_end_id": "E37839059202603091545abcdef02",
      "external_id": null,
      "type": "pix",
      "direction": "outbound",
      "status": "processing",
      "amount": 2500000,
      "fee_amount": 350,
      "net_amount": 2500350,
      "description": "Pagamento servico",
      "counterparty_name": "Maria Santos",
      "recipient_key": "98765432100",
      "created_at": "2026-03-09T15:45:00Z",
      "completed_at": null
    }
  ]
}

Campo	Tipo	Descripcion
data	Array	Lista de transacciones que corresponden al prefijo

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

Limite de resultados

La busqueda por tag retorna como maximo 50 transacciones por solicitud. Utilice prefijos mas especificos (ej: fecha completa) para refinar los resultados.

Respuesta Vacia -- 200

Cuando ninguna transaccion corresponde al prefijo informado:

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