الـ Webhooks
الـ Webhooks
ضيف رابط الـ webhook بتاعك في كارت المتجر في يودوو (https بس). يودوو بيبعت عليه حدث JSON كل ما طلب ياخد رد:
| الحدث | إمتى |
|---|---|
order.confirmed | العميل داس تأكيد، أو انت أكدت الطلب من يودوو (data.by = customer / merchant). |
order.cancelled | العميل داس إلغاء، أو انت لغيته من يودوو. السبب لو اتقال في data.order.confirmation.cancel_reason. |
webhook.test | دوست «ابعت حدث تجريبي»، أو استخدمت 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}"
}
}
} - رد بأي 2xx خلال 10 ثواني، واعمل الشغل التقيل بعد ما ترد.
- لو الإرسال فشل بنعيده بعد دقيقة، 5 دقايق، 30 دقيقة، ساعتين، 6 ساعات، 12 ساعة و24 ساعة، وبعدها بيتعلّم فاشل. كارت المتجر بيعرض آخر الإرساليات.
- نفس الحدث ممكن يوصل مرتين (إعادة بعد timeout): لو الـ id اتعامل معاه قبل كده تجاهله.
- اتأكد من التوقيع دايماً قبل ما تثق في أي حدث.
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 } } واقف في حاجة، أو محتاج حقل مش موجود؟ فريقنا بيرد على واتساب.