Detalles MED

Consulta los detalles completos de un proceso MED (Mecanismo Especial de Devolucion) especifico.

Endpoint

GET /api/external/med/:id

Headers

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

Path Parameters

Parametro	Tipo	Obligatorio	Descripcion
id	String	Si	Identificador del proceso MED

Ejemplo

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

Respuesta Exitosa (200)

{
  "worked": true,
  "med": {
    "id": "MED20260307001",
    "type": "FRAUDE",
    "status": "accepted",
    "amount": 50000,
    "original_end_to_end_id": "E37839059202603071530000001",
    "original_transaction_id": "PIXIN20260307a1b2c3d4e5f6",
    "requester_ispb": "12345678",
    "reason": "Fraude reportada pelo pagador",
    "created_at": "2026-03-07T18:00:00Z",
    "tracking": {
      "notification_received": "2026-03-07T18:00:00Z",
      "funds_blocked": "2026-03-07T18:00:05Z",
      "analysis_completed": null,
      "refund_completed": null
    }
  }
}

Campo	Tipo	Descripcion
worked	Boolean	true indica exito en la operacion
med.id	String	Identificador unico del MED
med.type	String	Tipo: FRAUDE o FALHA_OPERACIONAL
med.status	String	Estado actual del proceso
med.amount	Integer	Valor en unidades base (÷ 10.000 para reais)
med.original_end_to_end_id	String	E2E de la transaccion PIX original
med.original_transaction_id	String	ID de la transaccion PIX original
med.requester_ispb	String	ISPB de la institucion solicitante
med.reason	String	Motivo informado por el solicitante
med.created_at	String	Fecha de apertura (ISO 8601)
med.tracking	Object	Historial de etapas del proceso

Campos de tracking

Campo	Tipo	Descripcion
notification_received	String	Fecha de recepcion de la notificacion MED
funds_blocked	String	Fecha del bloqueo de valores (null si no fue bloqueado)
analysis_completed	String	Fecha de finalizacion del analisis (null si esta pendiente)
refund_completed	String	Fecha de la devolucion de valores (null si no fue devuelto)

Respuesta de Error (404)

{
  "worked": false,
  "detail": "MED nao encontrado"
}

Respuesta de Error (401)

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

Seguimiento

Utilice Webhooks con el evento pix.med para recibir notificaciones sobre cambios de estado del MED en tiempo real.