Listar MED

Lista os processos MED (Mecanismo Especial de Devolucao) associados a conta.

O MED e um mecanismo do Banco Central para recuperacao de valores em casos de fraude ou falha operacional no sistema PIX.

Endpoint

GET /api/v2/external/med

Headers

Header	Tipo	Obrigatorio	Descricao
Authorization	String	Sim	Bearer {access_token}

Exemplo

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

Resposta de Sucesso (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	Descricao
worked	Boolean	true indica sucesso na operacao
meds	Array	Lista de processos MED
meds[].id	String	Identificador unico do MED
meds[].type	String	Tipo do MED (veja tabela abaixo)
meds[].status	String	Status atual do processo
meds[].amount	Integer	Valor em centavos
meds[].original_end_to_end_id	String	E2E da transacao PIX original
meds[].created_at	String	Data de abertura (ISO 8601)

Tipos de MED

Tipo	Descricao
FRAUDE	Suspeita de fraude ou golpe
FALHA_OPERACIONAL	Falha no processamento do sistema

Status do MED

Status	Descricao
pending	MED em analise
accepted	MED aceito -- valores bloqueados na conta
refunded	Valores devolvidos ao pagador original
rejected	MED rejeitado apos analise
cancelled	MED cancelado

Resposta de Sucesso -- Sem MEDs (200)

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

Resposta de Erro (401)

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

Bloqueio de valores

Quando um MED e aceito (accepted), os valores correspondentes sao bloqueados na conta e descontados do saldo disponivel. Acompanhe via Detalhes MED e Webhook pix.med.