1. [ Home ](/) 2. [Guides](/guides) 3. [Integration](/guides?category=28) 4. Implementing Webhooks intermediate Integration 25 min 5 steps 12 min read # Implementing Webhooks A admin April 15, 2026 ## Prerequisites Prerequisites A publicly accessible HTTPS endpoint. Basic understanding of HTTP POST requests and JSON. ## On this page 5 steps total [ Back to top ](#main-content) ## What are Webhooks? Webhooks allow Aelix to push real-time event notifications to your application rather than requiring you to poll for updates. They are ideal for event-driven architectures and reduce unnecessary API calls. ## Step 1 — Register Your Endpoint In the Developer Portal, go to **Dashboard → Webhooks → Add Endpoint**. Enter your HTTPS URL and select the event types you want to receive: - account.created — New account opened - payment.completed — Payment successfully processed - payment.failed — Payment declined or failed - transaction.posted — Transaction recorded on account - kyc.status\_changed — KYC verification update ## Step 2 — Verify Signatures Every webhook delivery includes an X-Aelix-Signature header containing an HMAC-SHA256 hash of the request body, signed with your webhook secret. Always verify this before processing: const crypto = require('crypto'); function verifyWebhook(rawBody, signature, secret) { const expected = crypto .createHmac('sha256', secret) .update(rawBody, 'utf8') .digest('hex'); return crypto.timingSafeEqual( Buffer.from(expected, 'hex'), Buffer.from(signature, 'hex') ); } ## Step 3 — Respond Quickly Your endpoint must respond with **HTTP 200** within **5 seconds**. If processing takes longer, acknowledge immediately and process asynchronously: app.post('/webhooks/aelix', (req, res) => { // Acknowledge immediately res.status(200).json({ received: true }); // Process asynchronously processQueue.add(req.body); }); ## Step 4 — Handle Retries If your endpoint returns a non-200 response or times out, Aelix retries with exponential back-off: AttemptDelay1Immediate25 minutes330 minutes42 hours524 hours## Step 5 — Test Locally with Ngrok During development, use [ngrok](https://ngrok.com) to expose your local server: ngrok http 3000 \# Outputs: \# Register in the portal ### Tags Tags [Webhooks](/taxonomy/term/38) [REST](/taxonomy/term/36)