PayZu PaymentsCobranças

Acatar um chargeback


Aceite a disputa na adquirente quando você não for contestar o chargeback.

Acate o chargeback

A rota não recebe corpo.

bash
curl --request PUT \
  --url 'https://api.sandbox.payzu.dev/v1/charges/e3b7a1f2-8c4d-4a09-9f1e-2b6c8d5a7e90/chargebacks/4821375/accept' \
  --header "Authorization: Bearer $PAYZU_TOKEN" \
  --cert "$PAYZU_CLIENT_CERT" --key "$PAYZU_CLIENT_KEY"
Trecho da resposta
{
  "creditCardPayment": {
    "reversedAmount": 10000,
    "reversedDate": "2026-07-03T13:20:06.000Z",
    "chargebacks": [
      {
        "number": "4821375",
        "amount": 10000,
        "status": "ACCEPTED",
        "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": "ACCEPT",
          "reason": null,
          "disputeId": "c7d2e9a4-1f3b-4c58-9e60-2a7b8c9d0e1f",
          "documentName": null,
          "documentType": null,
          "documentSize": null,
          "documentHash": null,
          "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: Acatar um chargeback

  • Saldo: o valor da cobrança é debitado do saldo da sua conta na hora, mesmo que o saldo fique negativo.
  • Cobrança: o valor debitado aparece em reversedAmount e reversedDate.
  • Chargeback: passa a ACCEPTED, com response.action igual a ACCEPT.

O aceite não se desfaz.

Confira o id da cobrança e o number do chargeback antes de chamar a rota.

Erros desta operação

CódigoHTTPMensagem
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
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.