Pular para o conteúdo principal

​
O que é um MED?

O MED (Mecanismo Especial de Devolução) é um recurso do Banco Central que permite a devolução de valores em casos de:
  • Fraude - Transação não reconhecida pelo pagador
  • Falha operacional - Erro no processamento
  • Contestação - Pagador alega não recebimento do produto/serviço
Quando um MED é aberto contra você, você tem prazo limitado para apresentar sua defesa.
MEDs têm prazos rígidos. Configure webhooks para med:received e responda rapidamente.

​
Fluxo de um MED

​
Receber Notificação de MED

Configure um webhook para med:received: 
{
  "webhookId": "wh_abc123",
  "event": "med:received",
  "object": {
    "endToEndId": "E123456789...",
    "medId": "med_12345678...",
    "details": "Transação contestada pelo usuário pagador",
    "dtHrCreationReason": "2025-12-24T12:00:00.000Z",
    "entryId": "abc123def..."
  }
}

​
Consultar MEDs

Liste todos os MEDs recebidos: 
curl -X GET "https://api.owem.com.br/v4/i/meds?status=under_analysis" \
  -u "API_KEY:API_SECRET"

​
Campos Importantes

CampoDescrição
medIdIdentificador único do MED
endToEndIdE2E da transação original
statusunder_analysis, accepted, rejected
detailsMotivo da contestação
deadlines.defenseDeadLinePrazo para enviar defesa (timestamp)
grossAmountValor contestado

​
Enviar Defesa

A defesa deve ser enviada antes do prazo indicado em defenseDeadLine. Após o prazo, não é possível contestar.
curl -X POST "https://api.owem.com.br/v4/i/meds/{medId}/defense" \
  -u "API_KEY:API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Cliente realizou a compra e recebeu o produto conforme comprovantes anexos.",
    "files": [
      "https://storage.meusite.com/nf-12345.pdf",
      "https://storage.meusite.com/comprovante-entrega.pdf",
      "https://storage.meusite.com/conversa-cliente.pdf"
    ]
  }'

​
O que incluir na defesa?

Comprova a venda e os dados do cliente.
Rastreio, foto da entrega, assinatura do recebedor.
Prints de WhatsApp, email, chat que comprovem a negociação.
Se aplicável, políticas aceitas pelo cliente.
Registros que comprovem a entrega do serviço digital.

​
Status do MED

StatusDescriçãoAção
under_analysisMED em análiseEnviar defesa se ainda não enviou
acceptedMED aceito, valor devolvidoValor já foi debitado
rejectedMED rejeitado, valor mantidoNenhuma ação necessária

​
Exemplo: Monitoramento de MEDs

// Verificar MEDs pendentes diariamente
async function checkPendingMeds() {
  const response = await fetch(
    "https://api.owem.com.br/v4/i/meds?status=under_analysis",
    {
      headers: {
        Authorization: `Basic ${btoa("API_KEY:API_SECRET")}`,
      },
    }
  )

  const { data } = await response.json()

  for (const med of data) {
    const deadline = new Date(med.deadlines.defenseDeadLine)
    const now = new Date()
    const hoursLeft = (deadline - now) / (1000 * 60 * 60)

    if (hoursLeft < 24 && !med.defense) {
      // ALERTA: MED sem defesa com menos de 24h para o prazo
      await sendAlert({
        medId: med.medId,
        endToEndId: med.endToEndId,
        hoursLeft: hoursLeft.toFixed(1),
        amount: med.grossAmount,
      })
    }
  }
}

​
Boas Práticas

Ser notificado imediatamente é crucial para não perder o prazo.
Quanto antes enviar a defesa, melhor. Não espere o último dia.
Mantenha registros de todas as transações (NFs, entregas, conversas).
Verifique MEDs pendentes todos os dias para não perder prazos.
Se receber muitos MEDs, investigue a causa (fraude, insatisfação, etc).

​
Próximos Passos

API Reference

Documentação completa dos endpoints

Webhooks

Configurar notificações