Apontamento

Como configurar

1. Acesse Webhooks

   No painel da Alocis, vá até Configurações → Webhooks e clique em Criar Webhook.

2. Selecione os produtos

   Escolha os produtos que deseja monitorar. Você receberá notificações apenas dos produtos selecionados.

3. Informe a URL de destino

   Insira a URL HTTPS que receberá as notificações. Se não souber qual URL utilizar, consulte a documentação ou o suporte da plataforma que está integrando.

4. Escolha os eventos

   Selecione quais acontecimentos deseja acompanhar, como pagamentos aprovados, assinaturas canceladas ou carrinhos abandonados.

5. Teste a integração

   Antes de salvar, a Alocis enviará uma notificação de teste para verificar se a URL está funcionando. Seu servidor deverá responder com um status HTTP 2xx em até 10 segundos.

Requisitos da URL

• A URL deve ser HTTPS, pública e possuir um certificado SSL/TLS válido.
• Endereços locais e privados não são aceitos.
• Ao alterar a URL, será necessário realizar um novo teste com resposta 2xx.

Segurança

Como sua URL é pública, valide o token de segurança recebido em cada notificação para confirmar que a mensagem foi enviada pela Alocis.

Consulte a aba Autorização para aprender a validar o token corretamente.

Importante: a notificação de teste (endpoint.test) expira após 10 segundos. Para eventos reais, o tempo limite de cada tentativa é de 30 segundos.