PayZu PixWebhooks e callbacks

Segredo dos callbacks


Assine com um segredo da conta os avisos que a PayZu envia ao endereço de cada transação, para conferir a origem de cada um.

Crie o segredo

A chamada não tem corpo.

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

Referência: Criar o segredo dos callbacks

O secret, com 43 caracteres em base64url, vem uma única vez, nesta resposta. Se a conta já tem segredo, a resposta é 409: use a troca.

Enquanto a conta não tiver segredo, os avisos ao callbackUrl saem sem assinatura.

Sem o cabeçalho X-Callback-Signature, a sua aplicação não tem como conferir a origem.

Este segredo não vale para os webhooks.

Os webhooks cadastrados em POST /user/webhooks têm segredo próprio, gerado no cadastro ou em rotate-secret.

Erros desta operação

CódigoHTTPMensagem
PZG409409Usuário já possui um secret

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