Responder
Requer autenticação
POST/v2/account/infractions/reply
Envia defesa textual + evidências (até 5 arquivos PDF/JPG/PNG, 10MB cada). Esta é a única chance de defender a transação antes do prazo deadline_at.
Content-Type: multipart/form-data — não use JSON. Cada arquivo vai no campo files[].
Form fields
Parâmetros
idstringobrigatórioinfraction_id da disputa. messagestringobrigatórioTexto da defesa (até 5000 caracteres). Explique por que o pagamento é legítimo.
files[]fileArquivos de evidência. Tipos aceitos: PDF, JPG, PNG. Tamanho máx por arquivo: 10 MB. Máx 5 arquivos por reply.
Rate limit
10 reqs/min por credencial.
Erros
| Código | HTTP | Descrição |
|---|---|---|
MISSING_REQUIRED_FIELD | 400 | id ou message ausente |
INFRACTION_NOT_FOUND | 404 | infraction_id inválido |
INFRACTION_CLOSED | 409 | Disputa já resolvida — não aceita mais respostas |
DEADLINE_EXPIRED | 409 | Prazo de resposta expirou |
FILE_TOO_LARGE | 413 | Arquivo > 10 MB |
TOO_MANY_FILES | 422 | Mais de 5 arquivos |
UNSUPPORTED_FILE_TYPE | 422 | Tipo de arquivo não aceito |
Resposta 200
Após o reply, a infração muda de open → responded. A análise final é feita pelo PSP do pagador e você recebe o webhook chargeback.won / chargeback.lost / chargeback.canceled quando concluída (geralmente em até 7 dias úteis).
Boas práticas
- Anexe NF-e/contrato/comprovante de entrega sempre que possível
- Inclua prints de logs (IP, user-agent, geolocalização do checkout) para casos de fraude
- Documente o relacionamento prévio com o pagador (e-mails, mensagens) — fortalece defesa
- Responda dentro de 24h sempre que possível — mesmo com prazo de 7 dias, respostas rápidas têm mais peso na análise
