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"json
{
"message": "CallbackSecret criado com sucesso",
"secret": "Zk8Qk1Yb3nS6xPwT2cVrJ9dLmHgA4eN7uKfR0iXsBqE"
}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ódigo | HTTP | Mensagem |
|---|---|---|
PZG409 | 409 | Usuário já possui um secret |
Os códigos de autenticação e de validação estão no Catálogo de erros.