Webhooks
Webhooks
Add your webhook URL on the store's card in Yudoo (https only). Yudoo POSTs a JSON event to it whenever an order gets an answer:
| Event | When |
|---|---|
order.confirmed | The customer tapped Confirm, or you confirmed the order in Yudoo (data.by = customer / merchant). |
order.cancelled | The customer tapped Cancel, or you cancelled it in Yudoo. The reason, when given, is in data.order.confirmation.cancel_reason. |
webhook.test | You pressed Send a test event, or called POST /webhooks/test. |
POST https://mystore.com/yudoo/webhook
Content-Type: application/json
WhatPro-Event: order.cancelled
WhatPro-Delivery: evt_k3j9x2m1q8w7e6r5t4y3u2i1
WhatPro-Signature: t=1793782800,v1=5f2b8c…e91a
{
"id": "evt_k3j9x2m1q8w7e6r5t4y3u2i1",
"type": "order.cancelled",
"created_at": "2026-11-04T10:20:00.000Z",
"data": {
"by": "customer",
"order": {
"id": "1042",
"number": "#1042",
"status": "pending",
"confirmation": { "status": "cancelled", "at": "2026-11-04T10:19:58.000Z", "cancel_reason": "Changed my mind" },
"customer": { "name": "Mohamed Ali", "phone": "201001234567", "email": "mohamed@example.com" },
"…": "the same order object as GET /orders/{id}"
}
}
} - Answer with any 2xx within 10 seconds. Do the slow work after answering.
- A delivery that fails is retried after 1 min, 5 min, 30 min, 2 h, 6 h, 12 h and 24 h, then marked failed. The store's card shows the latest deliveries.
- The same event can arrive twice (a retry after a timeout): skip an id you already handled.
- Always check the signature before trusting an event.
POST/api/v1/webhooks/test
curl -X POST https://app.yudoo.io/api/v1/webhooks/test -H "Authorization: Bearer wp_live_your_api_key"
{ "delivery": { "id": "evt_…", "delivered": true, "error": null } } Stuck, or need a field we don't have yet? Our team answers on WhatsApp.