MED
MED é o pedido de devolução que o banco do comprador abre (fraude ou golpe). O valor da venda fica bloqueado no seu saldo até a decisão. Aqui dados descreve a disputa, não a cobrança.
Eventos desta família
| Evento | Quando chega | dados.status |
|---|---|---|
med.aberto | O banco do comprador abriu o MED. | aberta |
med.encerrado | O MED foi decidido. | ganha (valor liberado) ou perdida (valor devolvido ao comprador) |
Se o MED é perdido, chega também o venda.contestada, com a cobrança.
Campos de dados
idtextoIdentificador do MED: med_ + número.
cobrancatextoO id da cobrança contestada.
valorinteiroValor contestado, em centavos.
statustextoSituação do MED no momento do aviso: aberta, em_defesa, ganha ou perdida.
med.aberto
{
"id": "evt_6010",
"tipo": "med.aberto",
"sequencia": 6010,
"criado_em": "2026-10-20T09:12:00-03:00",
"dados": {
"id": "med_37",
"cobranca": "8f2c4b1e9a7d4c3b8e1f2a3b4c5d6e7f",
"valor": 9700,
"status": "aberta"
}
}med.encerrado
{
"id": "evt_6014",
"tipo": "med.encerrado",
"sequencia": 6014,
"criado_em": "2026-10-22T16:19:50-03:00",
"dados": {
"id": "med_37",
"cobranca": "8f2c4b1e9a7d4c3b8e1f2a3b4c5d6e7f",
"valor": 9700,
"status": "perdida"
}
}{
"id": "evt_6030",
"tipo": "med.encerrado",
"sequencia": 6030,
"criado_em": "2026-10-23T11:00:00-03:00",
"dados": {
"id": "med_38",
"cobranca": "3a9d0c2e7b1f4e6d9c8b7a6f5e4d3c2b",
"valor": 4990,
"status": "ganha"
}
}Use o campo cobranca para achar o pedido no seu sistema (pelo id da cobrança guardado quando você a criou). A defesa do MED é feita pelo painel, em Transações: a API ainda não tem rota para isso.