PayZu GatewayWebhooks
Consultar webhooks
Veja os webhooks cadastrados na conta, com o endereço, os eventos e o status de cada um.
Liste os webhooks
bash
curl https://api.sandbox.payzu.dev/v1/webhooks \
-H "Authorization: Bearer SUA_CHAVE_DE_API"json
{
"items": [
{
"id": "whe_oeQa3G4R1B4IW9KNJAiP1l",
"status": "active",
"url": "https://loja.exemplo.com.br/webhooks/payzu",
"description": "Sistema de pedidos",
"events": ["invoice.paid", "invoice.refunded", "subscription.canceled"],
"masked_secret": "****0000",
"created_at": "2026-11-11T15:20:59.433Z",
"updated_at": "2026-11-11T15:20:59.434Z"
}
],
"next_cursor": null
}Referência: Listar os webhooks cadastrados
- Ordem: do webhook mais novo para o mais antigo.
- Página: até 100 webhooks, com
next_cursorpara a seguinte, como em Paginação. - Filtros:
status(activeouinactive) e o dia de criação, comcreated_fromecreated_toem AAAA-MM-DD, no fuso de São Paulo. Parâmetro que a lista não tem é ignorado. - Segredo: aparece só mascarado, em
masked_secret.
Consulte um webhook
bash
curl https://api.sandbox.payzu.dev/v1/webhooks/whe_oeQa3G4R1B4IW9KNJAiP1l \
-H "Authorization: Bearer SUA_CHAVE_DE_API"A resposta traz o webhook no formato de cada item da lista.
Referência: Consultar um webhook
Status do webhook
| Status | O que significa |
|---|---|
active | Webhook ativo. Recebe os eventos da lista events. |
inactive | Webhook pausado. Não recebe eventos. |
Erros desta operação
| Código | HTTP | Mensagem |
|---|---|---|
| - | 404 | Webhook não encontrado para o id informado. |
Os erros de autenticação e de validação estão no Catálogo de erros.