> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://academy.zrupay.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Como configurar os Webhooks

# 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](https://academy.zrupay.com/pt/article/chave-publica-e-chave-secreta-15vg64g/).