Events and webhooks
1 min
Webhooks are HTTP callbacks that enable real-time event notifications from Jetpay to your application. Instead of repeatedly polling our API to check for updates, webhooks push data to your server as events occur, making your integration more efficient and responsive. Jetpay's webhook infrastructure delivers event notifications for critical business activities including transactions, user actions, company updates, KYC status changes, and payment platform events.
You can view our detailed schema for all webhook related API requests here.
Key features of our webhooks system include:
- Batch Delivery: Events are efficiently delivered in configurable batches (1-100 events) to reduce network overhead and improve throughput
- JWT Security: Every webhook request is signed with RS256 JWT tokens, ensuring authenticity and integrity
- Replay Capability: Start receiving events from a specific event ID or timestamp, perfect for recovery scenarios or new integrations
- Progress Tracking: Track delivery progress with last_sent_event_id to ensure no events are missed
- At-Least-Once Delivery: Guaranteed event delivery with automatic retry mechanisms
- Idempotency: Incremental event IDs ensure that you can accurately track what events you have already processed
- State Management: Clear webhook states (ACTIVE, SCHEDULED, DISPATCHING, BACKING_OFF, FAILED) for monitoring and debugging
To get started, check out our Quick Start guide. For more detailed information on the webhooks system, we have also included information in the following pages:
- Event Types Reference (a list of all the possible events that you can receive from our system)