Webhooks
Receive real-time notifications for booking events, payments, and voice calls
Overview
ETERA uses webhooks to notify your application of asynchronous events — payment confirmations, booking status changes, and voice call outcomes.
Stripe payment lifecycle events
Automated reservation call outcomes
AI Supervisor processing status
Webhook Types
Payment
Voice AI
Async Queue
The Payment service receives Stripe webhook events for payment lifecycle updates.
Stripe events include payment intent confirmations, refund updates, subscription changes, and invoice payments. See the Payment API reference for the full schema.
Verifying Stripe Signatures
Webhook Security
Always verify webhook signatures before processing events. For Stripe webhooks, use the Stripe-Signature header with your webhook signing secret.
Best Practices
Return 200 quickly
Acknowledge the webhook before processing. Use a queue for heavy work to avoid timeouts.
Handle duplicates
Webhooks may be sent more than once. Use event IDs for idempotency to prevent duplicate processing.
