Webhook Notifications
Webhook Notifications
Webhooks allow your system to receive real-time updates when events happen on Comm.Pix, without the need to constantly query our API.
Instead of polling for status changes, Comm.Pix sends an HTTP POST request to a callback URL that you configure whenever an important event occurs.
We currently send webhook notifications for:
Transactions (Charged)
Payment Links
BolePix
Each product has its own:
Event types
Payload structure
Status flow
Why Use Webhooks
Use webhooks to:
Track payment status in real time
Update your system automatically when a payment is completed, failed, or refunded
Trigger business logic (release product, confirm order, notify user, etc.)
Reduce unnecessary API polling
Webhooks are the main source of truth for asynchronous events.
Delivery and Security
Notifications are sent from fixed IP addresses.
Each event is delivered as an HTTP POST request.
You must return a successful response to confirm receipt.
If your endpoint fails, we automatically retry the delivery following our retry policy.
Important Notes
Always design your webhook endpoint to be idempotent.
Never assume webhooks will arrive only once.
Always validate and process events based on their unique IDs and type.
Webhooks are essential for building a reliable and event-driven integration with Comm.Pix.
Retry Policy
1st
0s
2nd
5m
3rd
10m
4th
20m
5th
45m
6th
1h30m
7th
3h
8th
6h
9th
12h
10th
24h