What are Webhooks?
Webhooks are HTTP POST requests sent by Pooler to a URL you specify when specific events occur. They allow your application to react immediately to events like payment completions, virtual account transactions, and errors.Why Use Webhooks?
Benefits
Real-Time Updates
Receive instant notifications when events occur - no polling required.
Efficient
Reduce API calls and server load by receiving only relevant events.
Reliable
Webhooks include retry mechanisms for failed deliveries.
Event-Driven
Build event-driven architectures that react to changes immediately.
Better UX
Update your application UI in real-time based on payment status.
Automation
Automate workflows based on payment events without manual intervention.
How Webhooks Work
Webhook Flow
1
Event Occurs
An event occurs in your Pooler account (e.g., payment completed, virtual account payment received).
2
Webhook Triggered
Pooler prepares a webhook payload with event data.
3
HTTP POST Request
Pooler sends an HTTP POST request to your webhook URL.
4
Your Server Receives
Your webhook endpoint receives and processes the request.
5
Response Sent
Your server responds with HTTP 200 to acknowledge receipt.
6
Retry if Failed
If your server doesn’t respond or returns an error, Pooler retries the webhook 4 times before back-off.
Webhook Events
Available Events
Pooler sends webhooks for various events:See the Webhook Events API for a complete list of available events.
Setting Up Webhooks
Step 1: Create Webhook Endpoint
Create an HTTP endpoint in your application to receive webhooks:Step 2: Configure Webhook URL
Configure your webhook URL in the Pooler dashboard:- Navigate to Settings → Developers
- Add your webhook URL
- Select events you want to receive
- Save configuration