PayZu PaymentsCobranças
Contestar um chargeback
Conteste a disputa enviando uma justificativa e um documento em multipart/form-data.
Conteste o chargeback
| Campo | Regra |
|---|---|
reason | Justificativa, com até 2.000 caracteres. |
document | Um único arquivo PDF, JPEG ou PNG de até 8 MB. O formato é conferido pelo conteúdo do arquivo, não pela extensão. |
bash
curl --request PUT \
--url 'https://api.sandbox.payzu.dev/v1/charges/e3b7a1f2-8c4d-4a09-9f1e-2b6c8d5a7e90/chargebacks/4821375/defense' \
--header "Authorization: Bearer $PAYZU_TOKEN" \
--cert "$PAYZU_CLIENT_CERT" --key "$PAYZU_CLIENT_KEY" \
--form 'reason=Produto entregue no endereço do comprador, com comprovante de entrega assinado.' \
--form 'document=@comprovante-entrega.pdf;type=application/pdf'Trecho da resposta
{
"creditCardPayment": {
"chargebacks": [
{
"number": "4821375",
"amount": 10000,
"status": "DEFENDED",
"reasonCode": "4837",
"reasonDescription": "Transação não reconhecida pelo portador",
"issuedAt": "2026-07-01T00:00:00.000Z",
"defenseDeadline": "2026-07-11T00:00:00.000Z",
"response": {
"action": "DEFENSE",
"reason": "Produto entregue no endereço do comprador, com comprovante de entrega assinado.",
"disputeId": "c7d2e9a4-1f3b-4c58-9e60-2a7b8c9d0e1f",
"documentName": "comprovante-entrega.pdf",
"documentType": "application/pdf",
"documentSize": 184320,
"documentHash": "9f2b6c1e4d8a7f3b0c5e2d9a6b1f4c8e7d3a0b5f2c9e6d1a8b4f7c3e0d5a2b9f",
"respondedBy": "api:loja-exemplo",
"providerMessage": null,
"createdAt": "2026-07-03T13:20:05.000Z"
},
"createdAt": "2026-07-01T10:15:00.000Z",
"updatedAt": "2026-07-03T13:20:06.000Z"
}
]
}
}Referência: Contestar um chargeback com documento
A resposta traz a cobrança inteira, com o chargeback em DEFENDED e response.action igual a DEFENSE.
DEFENDED quer dizer que a defesa foi entregue à adquirente.
A resposta não traz o resultado da disputa.
Erros desta operação
| Código | HTTP | Mensagem |
|---|---|---|
PZ611 | 400 | Envie um único documento |
PZ612 | 400 | Conteúdo multipart inválido |
PZ613 | 400 | Informe a justificativa (reason) |
PZ614 | 400 | Justificativa deve ter no máximo 2000 caracteres |
PZ615 | 400 | Envie o documento de defesa |
PZ616 | 400 | O arquivo deve ser enviado no campo "document" |
PZ617 | 400 | Documento deve ser PDF, JPEG ou PNG |
PZ618 | 400 | Envie a contestação como multipart/form-data |
PZ100 | 404 | Cobrança não encontrada |
PZ600 | 404 | Chargeback não encontrado |
PZ602 | 409 | Chargeback já respondido |
PZ603 | 409 | Chargeback já encerrado |
PZ604 | 409 | Já existe uma resposta em andamento para este chargeback |
PZ606 | 409 | Disputa já encerrada por prazo na adquirente |
PZ607 | 409 | A adquirente recusou a resposta porque a disputa já mudou de situação |
PZ610 | 413 | Documento acima de 8 MB |
PZ601 | 422 | Resposta a chargeback indisponível para esta cobrança |
PZ605 | 422 | Disputa não encontrada na adquirente (prazo encerrado ou chargeback sem disputa aberta) |
PZ608 | 422 | A adquirente recusou a resposta enviada |
PZ900 | 422 | O provedor de pagamento recusou a operação |
PZ901 | 503 | Não foi possível estabelecer comunicação com o provedor de pagamento. Tente novamente em instantes. |
Os erros de autenticação e de validação e os demais códigos estão no Catálogo de erros.