Listado MED

Lista los procesos MED (Mecanismo Especial de Devolucion) asociados a la cuenta.

El MED es un mecanismo del Banco Central para la recuperacion de valores en casos de fraude o falla operacional en el sistema PIX.

Endpoint

GET /api/external/med

Headers

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

Ejemplo

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

Respuesta Exitosa (200)

{
  "worked": true,
  "meds": [
    {
      "id": "MED20260307001",
      "type": "FRAUDE",
      "status": "pending",
      "amount": 50000,
      "original_end_to_end_id": "E37839059202603071530000001",
      "created_at": "2026-03-07T18:00:00Z"
    },
    {
      "id": "MED20260305002",
      "type": "FALHA_OPERACIONAL",
      "status": "refunded",
      "amount": 15000,
      "original_end_to_end_id": "E37839059202603051200000003",
      "created_at": "2026-03-05T14:30:00Z"
    }
  ]
}

Campo	Tipo	Descripcion
worked	Boolean	true indica exito en la operacion
meds	Array	Lista de procesos MED
meds[].id	String	Identificador unico del MED
meds[].type	String	Tipo del MED (ver tabla abajo)
meds[].status	String	Estado actual del proceso
meds[].amount	Integer	Valor en unidades base (÷ 10.000 para reais). 50000 = R$ 5,00
meds[].original_end_to_end_id	String	E2E de la transaccion PIX original
meds[].created_at	String	Fecha de apertura (ISO 8601)

Tipos de MED

Tipo	Descripcion
FRAUDE	Sospecha de fraude o estafa
FALHA_OPERACIONAL	Falla en el procesamiento del sistema

Estado del MED

Status	Descripcion
pending	MED en analisis
accepted	MED aceptado -- valores bloqueados en la cuenta
refunded	Valores devueltos al pagador original
rejected	MED rechazado luego del analisis
cancelled	MED cancelado

Respuesta Exitosa -- Sin MEDs (200)

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

Respuesta de Error (401)

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

Bloqueo de valores

Cuando un MED es aceptado (accepted), los valores correspondientes se bloquean en la cuenta y se descuentan del saldo disponible. Realice el seguimiento a traves de Detalles MED y Webhook pix.med.