Webhooks Quick Start

Webhooks are HTTP notifications Alguna sends to a URL you own when a billing event happens — an invoice is issued or paid, a payment fails, a subscription activates or cancels, a checkout completes, credits run out. Use them to keep your product, CRM or data warehouse in step with billing without polling. This guide sets up an endpoint from the dashboard; the full event catalogue, payload shapes and signature verification are on the Webhooks reference.

---

​

How Webhooks Work

When an event occurs (like an invoice being paid), Alguna sends a notification to a URL you specify. Your application can then take action based on that event.

---

​

Setting Up Webhooks

​

Step 1: Add a Webhook Endpoint

1. Go to Settings → Connections → Developers → Webhooks
2. Click Add Endpoint
3. Enter your webhook URL (provided by your development team)
4. Click Save

​

Step 2: Select Events

Choose which events you want to receive:

1. Click on your endpoint
2. Select the events you want to subscribe to
3. Click Save

​

Step 3: Copy the Webhook Secret

1. After saving, copy the Webhook Secret
2. Share this with your development team for signature verification — every delivery is signed, and the handler should reject anything that fails verification. See Verifying signatures.

---

​

Available Events

​

Subscription Events

​

Invoice Events

​

Payment Events

​

Credit Events

​

Other Events

Every event’s payload is documented on the Webhooks reference. Payloads are camelCase.

---

​

Testing Webhooks

Send test events to verify your setup:

1. Go to Settings → Connections → Developers → Webhooks
2. Select your endpoint
3. Click Send Test Event
4. Choose an event type
5. Verify the event was received and its signature verified

---

​

Viewing Webhook History

Track webhook deliveries:

1. Go to Settings → Connections → Developers → Webhooks
2. Select your endpoint
3. Click Message Logs
4. View delivery status, timestamps, and responses

---

​

Retry Policy

If delivery fails, Alguna retries automatically: If every attempt fails for 5 days, the endpoint is disabled.

---

​

Troubleshooting

​

Webhook Not Received

1. Check the endpoint URL is correct
2. Verify the endpoint is publicly accessible
3. Review Message Logs for error details
4. Ensure your server responds within 15 seconds

​

Endpoint Disabled

1. Check Message Logs for failure reasons
2. Fix any issues with your endpoint
3. Click Enable to reactivate

---

​

Best Practices

---

​

Next Steps