PayZu GatewayEventos de webhook

Contestação recebida

WEBHOOKchargeback.received

Confira o passo a passo → https://docs.payzu.com.br/docs/gateway/webhooks


Sai quando uma contestação nova é registrada.

Headers

X-Webhook-Eventstringobrigatório
Evento. O mesmo de type no corpo.chargeback.received
X-Webhook-Timestampstringobrigatório
Instante desta tentativa, em milissegundos (Unix). Muda a cada tentativa e entra na assinatura.
X-Webhook-Noncestringobrigatório
Valor aleatório, novo a cada tentativa. Entra na assinatura.
X-Webhook-Signaturestringobrigatório
HMAC-SHA256, em hexadecimal, de <X-Webhook-Timestamp>.<X-Webhook-Nonce>.<corpo cru>, calculado com o segredo do webhook.

Body

idstringobrigatório
ID do evento. O mesmo em todas as tentativas, no reenvio e em todos os webhooks que recebem o evento.
typestringobrigatório
Evento. O mesmo de X-Webhook-Event.chargeback.received
created_atstringobrigatório
Data e hora do evento, em UTC. Não muda na nova tentativa nem no reenvio.
dataobjectobrigatório
O recurso do evento em chargeback, como estava no momento do evento.
chargebackobjectobrigatório
A contestação registrada, com a fatura contestada em invoice.
idstringobrigatório
ID da contestação.
statusstringobrigatório
Status da contestação.receivedaccepteddefended
amountintegerobrigatório
Valor contestado, em centavos.
issued_atstringobrigatório
Data e hora em que o cliente contestou.
defense_deadlinestringobrigatório
Prazo para responder.
created_atstringobrigatório
Data e hora da criação.
updated_atstringobrigatório
Data e hora da última alteração.
disputeobjectobrigatório
Motivo da contestação.
codestring | nullobrigatório
Código do motivo na bandeira.
descriptionstring | nullobrigatório
Motivo em texto.
responseobject | nullobrigatório
Resposta enviada; nula sem resposta.
actionstringobrigatório
accept (aceite) ou defend (defesa).acceptdefend
notestring | nullobrigatório
Justificativa da defesa.
file_namestring | nullobrigatório
Nome do arquivo da defesa.
sent_atstringobrigatório
Data e hora do envio.
invoiceobjectobrigatório
Fatura contestada.
idstringobrigatório
ID da fatura.
statusstringobrigatório
Status da fatura.pendingpaidcanceledexpiredrefundedchargedback
urlstringobrigatório
Página da fatura.
external_referencestring | nullobrigatório
Sua referência da fatura.

Responses

2XXQualquer 2xx em até 5 segundos confirma a entrega. Redirecionamento conta como falha, e o corpo da resposta não é lido. Sem 2xx, a entrega volta a ser tentada 1 minuto, 10 minutos, 1 hora, 6 horas e 24 horas depois da tentativa anterior.

sem corpo

Exemploapplication/json
{  "id": "evt_3AHQXemt29GPWdksz8FNVc",  "type": "chargeback.received",  "created_at": "2026-11-20T12:05:48.220Z",  "data": {    "chargeback": {      "id": "chb_4TnW8xQcLb2MzYv7KdRh3E",      "status": "received",      "amount": 15990,      "issued_at": "2026-11-20T12:02:11.000Z",      "defense_deadline": "2026-11-30T02:59:59.000Z",      "created_at": "2026-11-20T12:05:48.220Z",      "updated_at": "2026-11-20T12:05:48.220Z",      "dispute": {        "code": "10.4",        "description": "Fraude em compra sem o cartão presente"      },      "response": null,      "invoice": {        "id": "in_7Kd2QmXvB9LtYc4WnRz8Hs",        "status": "chargedback",        "url": "https://invoice.payzu.com.br/pay/in_7Kd2QmXvB9LtYc4WnRz8Hs",        "external_reference": "pedido-1234"      }    }  }}