MED 2.0 — Recebimento de Recuperação de Valores

O MED 2.0 introduz a recuperação de valores (funds recovery), que unifica em um único fluxo o relato de infração e o pedido de devolução de uma transação PIX contestada. Ao receber uma recuperação de valores contra uma conta, a QI Tech automaticamente bloqueia de forma cautelar o recurso equivalente à transação contestada e envia uma notificação via webhook, dando a você a oportunidade de justificar a legitimidade da transação antes do fechamento.

O ciclo de vida de uma recuperação de valores recebida é:

1. awaiting_analysis — recuperação recebida e saldo bloqueado; aguardando a sua resposta, que deve ser enviada no prazo máximo de 5 dias.
2. pending_approval — resposta enviada (justificativa + arquivo de evidências); em análise pela QI Tech.
3. completed — fechada pela QI Tech, acatando (agreed) ou recusando (disagreed) a recuperação.
4. cancelled — cancelada pelo participante originador.

Toda a comunicação de acompanhamento é realizada via webhooks.

Webhook de uma incoming funds recovery

Uma incoming funds recovery é uma recuperação de valores aberta por outro participante, onde a sua conta é o alvo da transação contestada.

Observação

Os webhooks de recuperação de valores são enviados com webhook_type incoming.internal_infraction_report. Para diferenciá-los dos relatos de infração, verifique a presença do campo funds_recovery_key no objeto data.

Webhook: incoming funds recovery

{
  "event_datetime": "2026-07-16T16:48:43Z",
  "key": "0dedf537-a75e-4945-be1d-5d278c623022",
  "data": {
    "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": "awaiting_analysis",
    "situation_type": "scam",
    "report_details": "Transação acusada como fraudulenta pelo originador.",
    "infraction_amount": 150.50,
    "contact_email": "contato@participante.com.br",
    "contact_phone_number": "+5511999999999",
    "credited_participant": "32402502",
    "debited_participant": "12345678",
    "client_details": null,
    "analysis_result": null,
    "analysis_details": null,
    "blocked_balance_status": "completelly_blocked",
    "tracking_graph": null,
    "updated_at": "2026-07-16T16:48:43Z",
    "created_at": "2026-07-16T16:48:43Z"
  },
  "status": "awaiting_analysis",
  "webhook_type": "incoming.internal_infraction_report"
}

Objeto funds_recovery

Campo	Tipo	Descrição	Caracteres
funds_recovery_key *	string	UUID4 identificador da recuperação de valores na QI Tech.	32
funds_recovery_id *	string	Identificador da recuperação de valores no Bacen. Usado nas consultas e na resposta.	32
infraction_report_id *	string	Identificador da infração que originou a recuperação no Bacen.	32
pix_transfer_key *	string	Pix transfer key da transação original.	32
target_account_key *	string	Account key da conta de destino da transação original.	32
target_person_key *	string	Person key do alvo da recuperação.	32
end_to_end_id *	string	end_to_end_id da transação original.	32
funds_recovery_status *	string	Status da recuperação de valores.	Enumeradores funds_recovery_status
situation_type *	string	Situação apontada pelo originador.	Enumeradores situation_type
report_details	string	Detalhes enviados pelo participante originador.	2000
infraction_amount	number	Valor contestado. Quando ausente, considera-se o valor total da transação.	-
contact_email	string	E-mail de contato do participante originador.	255
contact_phone_number	string	Telefone de contato do participante originador.	20
credited_participant *	string	Participante que recebeu a transação.	8
debited_participant *	string	Participante que originou a transação.	8
client_awnser	string	Justificativa enviada na resposta. Presente após responder.	2000
analysis_result	string	Resultado da análise. Decidido pela QI Tech.	Enumeradores analysis_result
analysis_details	string	Justificativa do resultado da análise.	2000
blocked_balance_status *	string	Status do bloqueio de saldo da conta de destino.	Enumeradores blocked_balance_status
tracking_graph	object	Grafo de rastreamento das movimentações dos recursos contestados, quando disponível.	-
created_at *	string	Data e hora de criação.	20
updated_at *	string	Data e hora de alteração.	20

Enumeradores funds_recovery_status

Enumerador	Descrição
awaiting_analysis	Recuperação recebida e saldo bloqueado, aguardando a sua resposta.
pending_approval	Justificativa enviada, aguardando análise interna da QI Tech.
completed	Fechada pela QI Tech após a análise.
cancelled	Cancelada pelo participante originador.

Enumeradores situation_type

Enumerador	Descrição
scam	Causa de golpe ou estelionato.
account_takeover	Causa de transação não autorizada pela conta de origem.
coercion	Causa de crime de coerção.
fraudulent_access	Causa de acesso fraudulento à conta de origem.
other	Quaisquer causas não aplicáveis às listadas acima.

Enumeradores analysis_result

Enumerador	Descrição
agreed	A QI Tech acata a recuperação de valores e os recursos bloqueados são devolvidos.
disagreed	A QI Tech recusa a recuperação de valores e os recursos bloqueados são liberados.

Enumeradores blocked_balance_status

Enumerador	Descrição
completelly_blocked	Recursos equivalentes ao valor contestado completamente bloqueados.
partially_blocked	Recursos equivalentes ao valor contestado parcialmente bloqueados. Monitorando saldo.
no_balance	Conta sem saldo. Monitorando saldo pendente.
account_closed	Conta encerrada. Nenhum recurso bloqueado.