PayZu PaymentsCobranças

Contestar um chargeback


Conteste a disputa enviando uma justificativa e um documento em multipart/form-data.

Conteste o chargeback

CampoRegra
reasonJustificativa, com até 2.000 caracteres.
documentUm ú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ódigoHTTPMensagem
PZ611400Envie um único documento
PZ612400Conteúdo multipart inválido
PZ613400Informe a justificativa (reason)
PZ614400Justificativa deve ter no máximo 2000 caracteres
PZ615400Envie o documento de defesa
PZ616400O arquivo deve ser enviado no campo "document"
PZ617400Documento deve ser PDF, JPEG ou PNG
PZ618400Envie a contestação como multipart/form-data
PZ100404Cobrança não encontrada
PZ600404Chargeback não encontrado
PZ602409Chargeback já respondido
PZ603409Chargeback já encerrado
PZ604409Já existe uma resposta em andamento para este chargeback
PZ606409Disputa já encerrada por prazo na adquirente
PZ607409A adquirente recusou a resposta porque a disputa já mudou de situação
PZ610413Documento acima de 8 MB
PZ601422Resposta a chargeback indisponível para esta cobrança
PZ605422Disputa não encontrada na adquirente (prazo encerrado ou chargeback sem disputa aberta)
PZ608422A adquirente recusou a resposta enviada
PZ900422O provedor de pagamento recusou a operação
PZ901503Nã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.