PayZu Conta HubWebhooks e callbacks

Segredo dos callbacks


Nesta páginaConsulte o segredoCrie o segredoErros desta operação

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.

bash
curl --request GET \
  --url 'https://api.sandbox.payzu.dev/api/v1/transactions/callback-secret' \
  --header 'Authorization: Bearer SEU_TOKEN'

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.

bash
curl --request POST \
  --url 'https://api.sandbox.payzu.dev/api/v1/transactions/callback-secret' \
  --header 'Authorization: Bearer SEU_TOKEN'

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ódigoHTTPMensagem
CALLBACK_SECRET_ALREADY_ISSUED409Esta 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.