Skip to main content
O MED (Mecanismo Especial de Devolução) é o fluxo oficial do Banco Central para tratar solicitações de devolução de transações Pix por suspeita de fraude ou erro operacional. Quando uma notificação de infração é aberta ou tem seu status alterado, a API dispara um webhook para que você possa acompanhar o processo em tempo real.

​
INFRACTION_NOTIFICATION_CREATED

Disparado quando uma notificação de infração MED é aberta no sistema — geralmente iniciada pela instituição da parte debitada na transação original. Como registrar: 
{
  "eventType": "INFRACTION_NOTIFICATION_CREATED",
  "url": "https://seuservidor.com.br/webhooks/med",
  "authorizationScheme": "BEARER",
  "authorization": "seu-token"
}
Payload: 
{
    "id": "00287f1e-aa85-452c-9ca6-d08d810c571c",
    "endToEndId": "E38224857202501201735276EqueqSVM",
    "reason": "RETURN_REQUEST",
    "status": "PENDING",
    "debitedParticipant": {
        "ispb": "21018182",
        "name": "BOLETOBANCÁRIO.COM TECNOLOGIA DE PAGAMENTOS LTDA."
    },
    "creditedParticipant": {
        "ispb": "38224857",
        "name": "DELBANK"
    },
    "infractionDetails": "01",
    "analysisDetails": null,
    "createdAt": "2022-04-07T10:25:32.793Z",
    "updatedAt": "2025-02-13T16:35:13.907Z"
}

​
INFRACTION_NOTIFICATION_UPDATED

Disparado quando uma notificação de infração já existente tem seu status atualizado. O payload tem estrutura idêntica ao INFRACTION_NOTIFICATION_CREATED. Como registrar: 
{
  "eventType": "INFRACTION_NOTIFICATION_UPDATED",
  "url": "https://seuservidor.com.br/webhooks/med",
  "authorizationScheme": "BEARER",
  "authorization": "seu-token"
}

​
Campos do payload

CampoTipoDescrição
idstringIdentificador da notificação de infração
endToEndIdstringIdentificador da transação Pix relacionada
reasonenumMotivo da infração: FRAUD (fraude), RETURN_REQUEST (pedido de devolução), RETURN_CANCELLATION (cancelamento de devolução)
statusenumStatus atual: PENDING, CANCELED, ACCEPTED, REJECTED
debitedParticipant.ispbstringISPB da instituição que foi debitada na transação original
debitedParticipant.namestringNome da instituição debitada
creditedParticipant.ispbstringISPB da instituição que foi creditada na transação original
creditedParticipant.namestringNome da instituição creditada
infractionDetailsstringCódigo de detalhe do tipo de infração
analysisDetailsstringResultado da análise, preenchido após avaliação da infração
createdAtdateData de abertura da notificação
updatedAtdateData da última atualização