Segredo dos callbacks
Assine os avisos enviados à callbackUrl das suas operações com um segredo único da conta.
Consulte o segredo
Esta rota diz em hasCallbackSecret se a conta já tem segredo e nunca retorna o valor dele.
curl --request GET \
--url 'https://api.sandbox.payzu.dev/api/v1/transactions/callback-secret' \
--header 'Authorization: Bearer SEU_TOKEN'{ "hasCallbackSecret": true }Referência: Consultar o segredo dos callbacks
Crie o segredo
A criação responde 201 com o segredo em secret. Guarde-o no seu cofre: ele aparece uma única vez.
curl --request POST \
--url 'https://api.sandbox.payzu.dev/api/v1/transactions/callback-secret' \
--header 'Authorization: Bearer SEU_TOKEN'{ "secret": "2c26b46b68ffc68ff99b453c1d30413413422d706483bfa0f98a5e886266e7ae" }Referência: Criar o segredo dos callbacks
Sem o segredo, qualquer operação enviada com callbackUrl é recusada.
Cobrança, saque, pagamento de copia e cola e transferência entre contas aceitam callbackUrl, um endereço HTTPS público de até 2048 caracteres que recebe os avisos daquela operação. Crie o segredo na configuração inicial da conta, antes da primeira cobrança com callbackUrl.
Para substituir um segredo que já existe, veja Trocar o segredo dos callbacks.
Erros desta operação
| Código | HTTP | Mensagem |
|---|---|---|
CALLBACK_SECRET_ALREADY_ISSUED | 409 | Esta conta já tem um segredo de callback. Para trocá-lo, use a rotação. |
Todos os códigos do PayZu Conta Hub estão no Catálogo de erros.