Webhooks Overview
Outgoing webhooks allow you to receive real-time notifications when order events occur in EasyConfirm. When a customer confirms, cancels, or when a delivery fails, EasyConfirm will send an HTTP POST request to your registered webhook URL with the event details.
You can register and manage your webhook URLs from the EasyConfirm dashboard under Settings > Webhooks.
What's Included in Each Delivery
Every webhook delivery includes:
- An HMAC-SHA256 signature for verification (
X-EasyConfirm-Signatureheader) - An event type header (
X-EasyConfirm-Event) - A JSON payload with the full order data
Endpoint Requirements
Your webhook endpoint must:
- Accept HTTP POST requests with
Content-Type: application/json - Respond with a 2xx status code to confirm receipt
- Verify the signature to ensure the request is from EasyConfirm
:::tip Quick Setup Head to the EasyConfirm Dashboard to register your webhook URL and get your signing secret. :::
Supported Events
| Event | Trigger |
|---|---|
order.created | An order was created and the WhatsApp confirmation was sent successfully |
order.confirmed | The customer tapped the Approve button on WhatsApp |
order.canceled | The customer tapped the Cancel button on WhatsApp, or the order was canceled via the API |
order.failed | The WhatsApp message delivery failed |
info
Webhooks are fired only for orders created via the Public API (POST /api/v1/orders).