PayZu GatewayEventos de webhook

Teste do webhook

WEBHOOKping

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


Sai quando você testa o webhook no painel: uma entrega só, sem nova tentativa, que não depende da lista de eventos nem do status do webhook.

Headers

X-Webhook-Eventstringobrigatório
Evento. O mesmo de type no corpo.ping
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.ping
created_atstringobrigatório
Data e hora do evento, em UTC. Não muda na nova tentativa nem no reenvio.
dataobjectobrigatório
O webhook testado, em webhook.
webhookobjectobrigatório
O webhook testado, no formato da consulta dele.
idstringobrigatório
ID do webhook.
statusstringobrigatório
Status do webhook.activeinactive
urlstringobrigatório
Endereço que recebe os eventos.
descriptionstring | nullobrigatório
Descrição do webhook.
eventsarray of stringsobrigatório
Eventos que o webhook recebe.
masked_secretstringobrigatório
Final do segredo, para conferir qual está em uso.
created_atstringobrigatório
Data e hora da criação.
updated_atstringobrigatório
Data e hora da última alteração.

Responses

2XXQualquer 2xx em até 5 segundos confirma o teste. Sem 2xx, a entrega fica failed, sem nova tentativa.

sem corpo

Exemploapplication/json
{  "id": "evt_Vcjry7EMUbiqx6DLTahpw5",  "type": "ping",  "created_at": "2026-11-11T15:22:59.433Z",  "data": {    "webhook": {      "id": "whe_oeQa3G4R1B4IW9KNJAiP1l",      "status": "active",      "url": "https://loja.exemplo.com.br/webhooks/payzu",      "description": "Sistema de pedidos",      "events": [        "invoice.paid",        "invoice.refunded"      ],      "masked_secret": "****0000",      "created_at": "2026-11-11T15:20:59.433Z",      "updated_at": "2026-11-11T15:20:59.433Z"    }  }}