MED 2.0 — Responder Recuperação de Valores

Enquanto a recuperação de valores está com status awaiting_analysis, você pode respondê-la justificando a legitimidade da transação. A resposta é composta por uma explicação em texto e um arquivo .zip de evidências (nota fiscal, comprovantes, etc.), enviados como multipart/form-data.

Após a resposta, a recuperação passa para o status pending_approval, seguindo para a etapa de análise.

Aviso

O prazo máximo para responder a um MED é de 5 dias.

Identificador da recuperação de valores

O identificador utilizado na rota é o campo funds_recovery_id, recebido no webhook de incoming funds recovery no momento da abertura da recuperação.

O mesmo identificador também pode ser obtido pela listagem de recuperações de valores.

Request

ENDPOINT

/internal/pix/funds_recovery/incoming/FUNDS_RECOVERY_ID

MÉTODO

PATCH

Path params

Campo	Tipo	Descrição	Caracteres
FUNDS_RECOVERY_ID *	string	Identificador da recuperação de valores no Bacen (funds_recovery_id).	32

Form data

Campo	Tipo	Descrição	Caracteres
client_awnser *	string	Sua interpretação acerca da transação apontada como fraudulenta.	2000
file *	file	Arquivo .zip com as evidências que sustentam a justificativa. Tamanho máximo: 50MB.	-

Response

STATUS

200

Response Body

{
  "funds_recovery_key": "9eb5f452-81fd-4f67-9f2a-49e14e53ef64",
  "funds_recovery_id": "b8d19bd4-51dc-4784-a2ad-52807c6dfc80",
  "infraction_report_id": "3541127e-cbc9-44f6-bb0e-3e346ddaefb4",
  "pix_transfer_key": "957ef961-1824-47e6-90fd-f8b4775a1e1c",
  "target_account_key": "6711e3cf-fdf4-41b4-88e8-0a31cb83b9f4",
  "target_person_key": "4f6ea994-e53a-4ef8-b2b0-89d14c4667bc",
  "end_to_end_id": "E12345678202607161648s188f18bJty",
  "funds_recovery_status": "pending_approval",
  "situation_type": "scam",
  "report_details": "Transação acusada como fraudulenta pelo originador.",
  "infraction_amount": 150.50,
  "credited_participant": "32402502",
  "debited_participant": "12345678",
  "client_awnser": "Transação legítima, conforme demonstrado na nota fiscal XXXXXXXXXX que confirma a venda do produto.",
  "analysis_result": null,
  "analysis_details": null,
  "blocked_balance_status": "completelly_blocked",
  "tracking_graph": null,
  "funds_recovery_status_events": [
    {
      "old_status": null,
      "new_status": "awaiting_analysis",
      "created_at": "2026-07-16T16:48:43Z"
    },
    {
      "old_status": "awaiting_analysis",
      "new_status": "pending_approval",
      "created_at": "2026-07-17T10:12:05Z"
    }
  ],
  "updated_at": "2026-07-17T10:12:05Z",
  "created_at": "2026-07-16T16:48:43Z"
}

A resposta é o objeto funds_recovery atualizado, com funds_recovery_status = pending_approval e a justificativa em client_awnser.

Erros

Código	Status	Descrição
MED000042	400	A recuperação de valores não está com status awaiting_analysis.
MED000043	400	O arquivo enviado não é um arquivo .zip.
MED000044	400	O arquivo enviado excede o tamanho máximo de 50MB.
MED000039	404	Recuperação de valores não encontrada para o FUNDS_RECOVERY_ID informado.