O que é um Webhook?

Um webhook é uma notificação HTTP que o Zru envia ao seu servidor sempre que ocorre um evento relevante no seu ambiente: um pagamento é concluído, uma assinatura é cobrada, uma autorização é criada, etc.

Como configurar um Webhook

• Vá a Desenvolvedores no menu lateral esquerdo.
• Selecione o separador «Webhooks».
• Clique em «Adicionar webhook».
• Insira um Nome para identificar o webhook (por exemplo: «Notificações para o CRM»).
• Insira o URL do seu endpoint.
• Em Tipos de notificação, escolha os eventos que pretende receber. Estão agrupados em nove categorias que pode expandir: Transações, Assinaturas, Autorizações, Vendas, Transferências, Clientes, Wallets, IBAN e Checkout.
• Use o toggle Habilitado para ativar ou desativar o webhook ao criá-lo.
• Clique em «Criar».

🧐 Cada categoria mostra um contador com os tipos que selecionou sobre o total, e tem um Selecionar todo para os marcar de uma vez.

🧐 Junto ao nome de cada evento verá o seu identificador técnico (por exemplo transaction_confirmation_error). É o valor que receberá na notificação, pelo que lhe serve para programar a sua integração.

✋ Tem de escolher pelo menos um tipo de notificação para poder criar o webhook.

Ações disponíveis sobre os Webhooks

Uma vez criado, o webhook aparece na lista com o seu Nome, o seu URL, o Tipo (os identificadores dos eventos a que está subscrito) e se está Habilitado. A partir do cabeçalho pode filtrar por estado e exportar a lista em CSV.

Verificação da entrega

Em Desenvolvedores ▶️ Notificações pode ver todas as notificações enviadas ao seu endpoint e as respostas devolvidas.

Segurança dos webhooks

🧐 As notificações são sempre assinadas com a Chave predefinida do ambiente. Pode saber mais neste guia.

Actualizado em: 11/08/2026