PayZu PixWebhooks e callbacks

Trocar o segredo de um webhook


Gere um segredo novo para um webhook, por exemplo quando houver suspeita de vazamento.

Troque o segredo

bash
curl -X POST https://pix.sandbox.payzu.dev/v1/user/webhooks/cm3w7k1t40000q8f2r5b9x3ad/rotate-secret \
  -H "Authorization: Bearer SEU_TOKEN"

Referência: Trocar o segredo de um webhook

O segredo anterior é invalidado na hora, e o novo aparece só nesta resposta.

Atualize a sua aplicação logo depois da troca.

Toda entrega enviada depois da troca, inclusive retentativas de eventos anteriores, sai assinada com o segredo novo.

Num webhook cadastrado sem segredo, a troca cria um e as entregas passam a ser assinadas.

Erros desta operação

CódigoHTTPMensagem
PZG404404Webhook não encontrado

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