PayZu PixWebhooks e callbacks

Alterar um webhook


Troque a URL ou os eventos de um webhook, ou pause as entregas sem excluir o cadastro.

Altere ou pause

Envie pelo menos um campo.

bash
curl -X PATCH https://pix.sandbox.payzu.dev/v1/user/webhooks/cm3w7k1t40000q8f2r5b9x3ad \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "active": true }'

Referência: Alterar um webhook

CampoEfeito
urlVale para todo envio seguinte, inclusive retentativas que já estavam na fila.
eventsSubstitui a lista inteira.
activefalse pausa e true reativa.

Pausar descarta os avisos.

Os eventos do período e as retentativas pendentes não são entregues, não aparecem em GET /user/callbacks e não voltam ao reativar. Para repor o período, consulte as transações em GET /user/transactions.

Erros desta operação

CódigoHTTPMensagem
PZA204403Conta bloqueada para alterações. Desbloqueie a conta antes de alterar.
PZG404404Webhook não encontrado
PZG409409Limite de 5 webhooks ativos atingido

Os códigos de autenticação e de validação estão no Catálogo de erros.