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:

EventWhen
order.confirmedThe customer tapped Confirm, or you confirmed the order in Yudoo (data.by = customer / merchant).
order.cancelledThe customer tapped Cancel, or you cancelled it in Yudoo. The reason, when given, is in data.order.confirmation.cancel_reason.
webhook.testYou pressed Send a test event, or called POST /webhooks/test.
http
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}"
    }
  }
}

POST/api/v1/webhooks/test

bash
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.

Ask us on WhatsAppOpen the Yudoo app