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
CrossChain Events
bridge.initiated
Cross-chain bridge transfer started
bridge.completed
Bridge transfer confirmed on destination chain
bridge.failed
Bridge transfer failed or timed out
swap.completed
Cross-chain token swap completed
DeFi Events
position.opened
DeFi position opened (lending, staking, LP)
position.closed
DeFi position closed and funds returned
position.liquidation_warning
Position approaching liquidation threshold
yield.harvested
Yield rewards harvested from protocol
RegTech Events
compliance.report.generated
MiFID II or MiCA compliance report ready
compliance.violation.detected
Regulatory compliance violation detected
travel_rule.check.completed
Travel Rule verification completed
Mobile Payment Events
payment_intent.created
New payment intent initialized
payment_intent.completed
Payment intent successfully fulfilled
payment_intent.expired
Payment intent expired without completion
Partner BaaS Events
partner.onboarded
New BaaS partner onboarding completed
sdk.generated
Partner SDK build generated and ready
widget.deployed
Embedded widget deployed to production
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