PayZu GatewayEstornos e contestações

Aceitar uma contestação


Nesta páginaAceite a contestaçãoConfirme o aceiteErros desta operação

Aceitar encerra a disputa a favor do portador do cartão, e o valor do pagamento é debitado do saldo da sua conta.

Aceite a contestação

bash
curl -X POST https://api.sandbox.payzu.dev/v1/chargebacks/chb_4TnW8xQcLb2MzYv7KdRh3E/accept \
  -H "Authorization: Bearer SUA_CHAVE_DE_API"
Trecho da resposta
{
  "id": "chb_4TnW8xQcLb2MzYv7KdRh3E",
  "status": "accepted",
  "response": {
    "action": "accept",
    "note": null,
    "file_name": null,
    "sent_at": "2026-11-21T09:40:27.530Z"
  }
}

Referência: Aceitar uma contestação

A rota não tem corpo, e a Idempotency-Key é opcional. A resposta 200 traz a contestação inteira, no formato de Consultar uma contestação.

O aceite não se desfaz.

Depois dele, a defesa é recusada. Só a contestação received aceita resposta, e só até defense_deadline.

Confirme o aceite

Quando o aceite é registrado, os webhooks da conta recebem chargeback.responded, com a contestação em data.chargeback; veja Contestação respondida. O efeito na fatura e na assinatura está em Contestações.

SituaçãoResposta
Repetir a mesma ação200, com a contestação como ficou na primeira chamada, sem enviar nada de novo.
Enviar a outra ação409, porque a contestação já foi respondida.
Duas respostas ao mesmo tempoA segunda recebe 409, porque já existe uma resposta em andamento.
A adquirente não confirma a tempoA PayZu relê a contestação antes de responder: com a resposta registrada, a chamada responde 200.

Erros desta operação

CódigoHTTPMensagem
PZ031403Esta conta só tem acesso de consulta.
PZ032403Cartão não habilitado para esta conta. Fale com o suporte para habilitar ou ofereça apenas Pix.
PZ600404Contestação não encontrada para o id informado.
PZ601409Esta contestação já foi respondida ou encerrada.
PZ602409O prazo para responder a esta contestação terminou.
PZ603409Já existe uma resposta em andamento para esta contestação.
PZ604422A resposta não foi aceita. Revise a justificativa e o arquivo e envie de novo.
PZ605422Não foi possível responder a esta contestação agora. Tente de novo mais tarde.

Os erros de autenticação e de idempotência estão no Catálogo de erros.