PayZu PixDevoluções e MED
Responder uma infração MED
Responda a uma infração MED com o seu relato e os documentos que comprovam o Pix.
Envie a defesa
Mande o texto no campo defense e cada arquivo num campo files.
bash
curl -X POST https://pix.sandbox.payzu.dev/v1/user/infractions/cm3w7n2p60002q8f2h7d3z5cf/defenses \
-H "Authorization: Bearer SEU_TOKEN" \
-F "defense=A cobranca foi autorizada pelo titular. Comprovante em anexo." \
-F "files=@comprovante.pdf;type=application/pdf"json
{
"id": "defense_id",
"defense": "Esta transação foi devidamente autorizada pelo cliente através do app mobile.",
"status": "PENDING",
"infractionId": "infraction_123",
"createdAt": "2024-01-16T14:20:00Z",
"updatedAt": "2024-01-16T14:20:00Z",
"files": [
{
"name": "evidencia1.pdf",
"mimeType": "application/pdf",
"size": 245760,
"url": "https://.../evidencia1.pdf?assinatura=..."
}
]
}js
import { readFile } from 'node:fs/promises'
const form = new FormData()
form.append('defense', 'A cobranca foi autorizada pelo titular. Comprovante em anexo.')
const pdf = await readFile('comprovante.pdf')
form.append('files', new Blob([pdf], { type: 'application/pdf' }), 'comprovante.pdf')
const response = await fetch(
'https://pix.sandbox.payzu.dev/v1/user/infractions/cm3w7n2p60002q8f2h7d3z5cf/defenses',
{ method: 'POST', headers: { authorization: `Bearer ${process.env.PAYZU_TOKEN}` }, body: form }
)
const defense = await response.json()
if (!response.ok) throw new Error(`${defense.errorCode}: ${defense.message}`)
console.log(defense.id, defense.status)Referência: Enviar a defesa de uma infração MED
Na resposta 201, cada anexo vem com um link temporário em files[].url, válido por 9 minutos.
A API só aceita defesa com a infração OPEN.
Em qualquer outro status, inclusive DEFENDED, a resposta é 422. Envie a defesa antes de expiresAt, quando houver; confira os dois em Consultar uma infração.
Não defina Content-Type à mão no multipart.
O cliente HTTP monta o boundary. Com curl -F e com o fetch do Node.js isso é automático.
O andamento da defesa está em Consultar as defesas.
Erros desta operação
| Código | HTTP | Mensagem |
|---|---|---|
PZK213 | 403 | Envio de defesa não habilitado na instituição financeira desta transação. |
PZG404 | 404 | Infração não encontrada |
PZG422 | 422 | Não é possível defender esta infração |
Os códigos de autenticação e de validação estão no Catálogo de erros.