Real-time Event System
Webhooks
Real-time notifications for account events, transaction updates, and workflow completions delivered directly to your application.
How Webhooks Work
Never miss an important event. Get instant HTTP POST notifications when things happen in your FinAegis account.
Event Occurs
Transaction completes or account changes
Webhook Triggered
Event queued for delivery
POST Request Sent
Secure HTTPS delivery to your endpoint
You Respond
Process event and return 200 OK
Quick Setup
curl -X POST https://api.finaegis.org/v2/webhooks \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{"url": "https://yourapp.com/webhooks", "events": ["*"]}'Available Events
Subscribe to exactly what you need
Account Events
account.created
New account opened
account.updated
Account details changed
account.balance_updated
Balance changed
account.frozen
Account frozen
account.unfrozen
Account unfrozen
account.closed
Account closed
Transfer Events
transfer.created
Transfer initiated
transfer.pending
Transfer processing
transfer.completed
Transfer successful
transfer.failed
Transfer failed
transfer.reversed
Transfer reversed
transfer.expired
Transfer expired
Workflow Events
workflow.started
Workflow initiated
workflow.step_completed
Step finished
workflow.completed
Workflow finished
workflow.failed
Workflow failed
workflow.timeout
Workflow timed out
workflow.compensation_executed
Rollback completed
System Events
system.maintenance_start
Maintenance begins
system.maintenance_end
Maintenance ends
system.rate_limit_warning
Approaching rate limit
system.api_key_expiring
API key expiring soon
system.security_alert
Security event detected
system.status_change
System status changed
Implementation Guide
Get up and running in minutes
Complete Code Examples Available
We have comprehensive webhook implementation examples with signature verification, error handling, and idempotency patterns ready for you to use.
View Webhook ExamplesReady to receive real-time events?
Set up your first webhook in minutes