Detalhes MED

Consulta os detalhes completos de um processo MED (Mecanismo Especial de Devolucao) especifico.

Endpoint

GET /api/v2/external/med/:id

Headers

Header	Tipo	Obrigatorio	Descricao
Authorization	String	Sim	Bearer {access_token}

Path Parameters

Parametro	Tipo	Obrigatorio	Descricao
id	String	Sim	Identificador do processo MED

Exemplo

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

Resposta de Sucesso (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	Descricao
worked	Boolean	true indica sucesso na operacao
med.id	String	Identificador unico do MED
med.type	String	Tipo: FRAUDE ou FALHA_OPERACIONAL
med.status	String	Status atual do processo
med.amount	Integer	Valor em centavos
med.original_end_to_end_id	String	E2E da transacao PIX original
med.original_transaction_id	String	ID da transacao PIX original
med.requester_ispb	String	ISPB da instituicao solicitante
med.reason	String	Motivo informado pelo solicitante
med.created_at	String	Data de abertura (ISO 8601)
med.tracking	Object	Historico de etapas do processo

Campos de tracking

Campo	Tipo	Descricao
notification_received	String	Data de recebimento da notificacao MED
funds_blocked	String	Data do bloqueio dos valores (null se nao bloqueado)
analysis_completed	String	Data da conclusao da analise (null se pendente)
refund_completed	String	Data da devolucao dos valores (null se nao devolvido)

Resposta de Erro (404)

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

Resposta de Erro (401)

{
  "worked": false,
  "detail": "Token invalido ou expirado"
}

Acompanhamento

Utilize Webhooks com o evento pix.med para ser notificado sobre mudancas de status no MED em tempo real.