PayZu GatewayEstornos e contestações
Aceitar uma contestaçã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ção | Resposta |
|---|---|
| Repetir a mesma ação | 200, com a contestação como ficou na primeira chamada, sem enviar nada de novo. |
| Enviar a outra ação | 409, porque a contestação já foi respondida. |
| Duas respostas ao mesmo tempo | A segunda recebe 409, porque já existe uma resposta em andamento. |
| A adquirente não confirma a tempo | A PayZu relê a contestação antes de responder: com a resposta registrada, a chamada responde 200. |
Erros desta operação
| Código | HTTP | Mensagem |
|---|---|---|
PZ031 | 403 | Esta conta só tem acesso de consulta. |
PZ032 | 403 | Cartão não habilitado para esta conta. Fale com o suporte para habilitar ou ofereça apenas Pix. |
PZ600 | 404 | Contestação não encontrada para o id informado. |
PZ601 | 409 | Esta contestação já foi respondida ou encerrada. |
PZ602 | 409 | O prazo para responder a esta contestação terminou. |
PZ603 | 409 | Já existe uma resposta em andamento para esta contestação. |
PZ604 | 422 | A resposta não foi aceita. Revise a justificativa e o arquivo e envie de novo. |
PZ605 | 422 | Nã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.