Webhook MED

🚨 Webhook — Infração MED (PIX)

Disparado quando somos notificados pelo Banco Central de uma infração do Mecanismo Especial de Devolução (MED) sobre uma transação PIX do merchant.

A notificação é enviada para o callbackUrl informado na criação do qrCode Pix.

O merchant possui um prazo de 72 horas para contestar antes que os fundos sejam devolvidos ao pagador. A contestação deve ser realizada no menu Infrações Pix do portal da RedFox Pay.

transactionType: INFRACTION

Exemplo de Payload

{
  "transactionId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "transactionType": "INFRACTION",
  "transactionStatus": "INFRACTION",
  "amount": 350.00,
  "endToEndId": "E35713491202604092031205962c9eff",
  "infractionId": "A1B2C3D4-E5F6-7890-ABCD-EF1234567890",
  "infractionExpiredDate": "2026-09-15 23:59:59"
}

Campos

Campo	Tipo	Sempre presente	Descrição
transactionId	string (UUID)	Sim	Identificador da transação PIX original que originou a infração.
transactionType	string	Sim	Sempre `INFRACTION` para este webhook.
transactionStatus	string	Sim	Sempre `INFRACTION` para este webhook.
amount	number	Sim	Valor disputado na infração, em reais (BRL).
endToEndId	string	Sim	Identificador fim-a-fim da transação PIX no Banco Central.
infractionId	string (UUID)	Sim	Referência interna da RedFox para esta infração MED.
infractionExpiredDate	string	Sim	Prazo máximo para contestar, no formato `YYYY-MM-DD HH:mm:ss`. Após esta data o MED é encerrado automaticamente.

⏱
Atenção ao prazo. O campo infractionExpiredDate indica o limite para envio de contestação.
Após esse prazo, o valor disputado pode ser devolvido ao pagador.

Status possíveis

Valor	Descrição
INFRACTION	Infração recebida e registrada. Envie a defesa dentro do prazo indicado em `infractionExpiredDate`.

🚨 Webhook — Infração MED (PIX)

Exemplo de Payload

Campos

Atenção ao prazo. O campo infractionExpiredDate indica o limite para envio de contestação.

Status possíveis

Atenção ao prazo. O campo `infractionExpiredDate` indica o limite para envio de contestação.