Como consultar as notificações de infração de uma recuperação de fundos (MED)?

Uma notificação de infração (infraction report) é o registro de fraude que uma instituição envia ao Banco Central sobre uma transação Pix. Ao abrir uma recuperação de fundos, a Woovi registra a notificação de infração da transação original; a instituição do recebedor deve reconhecê-la e responder se concorda ou não com o relato.

Para consultar as notificações de infração ligadas a uma recuperação de fundos, faça uma chamada GET para o endpoint /api/v1/funds-recovery/{id}/infraction-reports, usando como {id} o dictId retornado na criação ou o endToEndId da transação Pix que originou a recuperação.

Exemplo

Se tudo ocorreu bem, o status code da requisição será 200 e no body da resposta retornaremos a lista de notificações de infração da sua conta relacionadas à recuperação de fundos:

[
  {
    "bacenInfractionReportId": "7c2e4b1a-3d5f-4a6b-9c8d-0e1f2a3b4c5d",
    "fundsRecoveryId": "3e760cd5-39b2-45da-8ab6-b212cf205568",
    "transactionId": "E31680151202606101530AbCdEf12345",
    "reason": "REFUND_REQUEST",
    "situationType": "SCAM",
    "reportDetails": "Pagamento realizado para um falso vendedor. Após o pagamento, o vendedor parou de responder e não entregou o produto.",
    "status": "CLOSED",
    "analysisResult": "AGREED",
    "analysisDetails": "Conta do recebedor bloqueada após verificação.",
    "reporterParticipant": "31680151",
    "counterpartyParticipant": "12345678",
    "infractionAmount": 50000,
    "contactInformation": {
      "email": "[email protected]",
      "phone": "+5511999999999"
    },
    "creationTime": "2026-06-11T00:30:00.000Z",
    "lastModified": "2026-06-11T12:00:00.000Z",
    "createdAt": "2026-06-11T00:30:00.000Z",
    "updatedAt": "2026-06-11T12:00:00.000Z"
  }
]

Campos principais

Campo	Descrição
status	OPEN ao ser registrada, ACKNOWLEDGED quando a outra instituição a reconhece, CLOSED após a análise, CANCELLED se cancelada.
reason	REFUND_REQUEST para um pedido de devolução; REFUND_CANCELLED quando a devolução foi cancelada.
situationType	A situação relatada: SCAM, ACCOUNT_TAKEOVER, COERCION, FRAUDULENT_ACCESS, OTHER ou UNKNOWN.
analysisResult	Resposta da outra instituição após a análise: AGREED ou DISAGREED.
reporterParticipant	ISPB da instituição que registrou a notificação.
counterpartyParticipant	ISPB da instituição da contraparte.
infractionAmount	Valor da transação reportada, em centavos.

Possíveis erros

Status	Motivo
401	AppID inválido ou ausente
403	Sua conta não possui a funcionalidade MED API ou o AppID não possui o escopo necessário
404	Recuperação de fundos não encontrada para a sua conta

Exemplos em código

Shell + cURL

curl --request GET \
    --url https://api.woovi.com/api/v1/funds-recovery/3e760cd5-39b2-45da-8ab6-b212cf205568/infraction-reports \
    --header 'Authorization: AUTHORIZATION'

JavaScript + Fetch

fetch(
  'https://api.woovi.com/api/v1/funds-recovery/3e760cd5-39b2-45da-8ab6-b212cf205568/infraction-reports',
  {
    method: 'GET',
    headers: {
      Authorization: 'AUTHORIZATION',
    },
  },
).then((res) => res.json());