Guia de disputas MED

Disputas MED no trilho PADRAO (PIX regulado). A API key precisa das permissões meds/list, meds/get e meds/evidence.

Fluxo típico

1. Webhook med.created

Quando uma disputa abre, a GoatPay envia med.created (configure em Webhooks).

2. Listar ou consultar

Use Listar ou Consultar pelo id ou protocol.

3. Enviar defesa

Enquanto status for OPEN, envie Evidências com justificativa e comprovantes.

4. Resultado

Após análise do PSP: ACCEPTED, REJECTED, CANCELED ou EXPIRED. Eventos med.resolved / med.evidence_sent via webhook.

Status	Significado
`OPEN`	Aberta — aceita envio de evidências
`UNDER_REVIEW`	Defesa enviada, aguardando PSP
`ACCEPTED`	Disputa aceita (valor não retorna ao disponível)
`REJECTED`	Rejeitada a favor do recebedor
`CANCELED`	Cancelada
`EXPIRED`	Expirada

MED em PIX creditado na conta principal bloqueia availableWhite e blockedAmount da main.
MED em PIX creditado em subconta (subaccountId na cobrança) bloqueia saldo da subconta (availableWhite → lockedWhite), sem debitar a main.
Chaves no trilho LIVRE não recebem MED via esta integração.
Saques cripto no PADRAO podem ser bloqueados enquanto houver MED OPEN ou UNDER_REVIEW na conta.

Detalhes de subcontas: guia de subcontas.

Enquanto status for OPEN:

Campo	Regra
`justification`	Obrigatório (10–2000 caracteres)
`proofs`	Até 10 URLs públicas; pode ser obrigatório conforme o processador
`analysis`	`aceito` ou `rejeitado`; obrigatório em alguns fluxos, ignorado em outros
`files`	Multipart: até 5 arquivos (PDF/JPG/PNG/WEBP, máx. 5 MB cada) quando suportado

Envie JSON (application/json) ou multipart/form-data com os mesmos campos. Detalhes em Enviar evidências.

Disputas de seed local em desenvolvimento não aceitam defesa real. Use MED aberta pelo fluxo de produção.

Parâmetro	Descrição
`page` / `pageSize`	Paginação (máx. 100 por página)
`dateFrom` / `dateTo`	Período em `openedAt` (ISO 8601)
`status`	`OPEN`, `UNDER_REVIEW`, `ACCEPTED`, `REJECTED`, `CANCELED`, `EXPIRED`
`search`	Busca em `id`, `protocol`, `transactionId`, `infractionId`

Disputas da conta.

Por id ou protocolo.

Defesa + anexos.