PayZu GatewayEventos de webhook

Contestação respondida

WEBHOOKchargeback.responded

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


Sai quando o aceite ou a defesa da contestação fica registrado. O prazo que vence sem resposta não envia este evento.

Headers

X-Webhook-Eventstringobrigatório
Evento. O mesmo de type no corpo.chargeback.responded
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.responded
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 com a resposta em response.
idstringobrigatório
ID da contestação.
statusstringobrigatório
Status da contestação: accepted ou defended neste evento.accepteddefended
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_GPWdksz8FNVcjry7EMUbiq",  "type": "chargeback.responded",  "created_at": "2026-11-21T09:40:27.530Z",  "data": {    "chargeback": {      "id": "chb_4TnW8xQcLb2MzYv7KdRh3E",      "status": "defended",      "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-21T09:40:27.530Z",      "dispute": {        "code": "10.4",        "description": "Fraude em compra sem o cartão presente"      },      "response": {        "action": "defend",        "note": "Produto entregue em 05/11, com assinatura do comprador.",        "file_name": "comprovante-entrega.pdf",        "sent_at": "2026-11-21T09:40:27.530Z"      },      "invoice": {        "id": "in_7Kd2QmXvB9LtYc4WnRz8Hs",        "status": "chargedback",        "url": "https://invoice.payzu.com.br/pay/in_7Kd2QmXvB9LtYc4WnRz8Hs",        "external_reference": "pedido-1234"      }    }  }}