🔄 Order Status Update (From Blend to Delivery App)

🧾 Description

This document explains the order_updated event that Blend sends to the delivery app
when the order status is updated from Blend’s system — such as via the merchant dashboard or kitchen display system.

This allows Blend to notify the delivery partner of important changes to the order's lifecycle.

🔁 Direction

Blend → Delivery App

Blend pushes this event to the delivery app's registered webhook URL.

📦 Example Payload

{
  "event": "order_updated",
  "event_time": "2025-01-01 00:00:00",
  "branch_id": "14589",
  "payload": {
    "order_id": "order_id",
    "status": "accepted"
  }
}

🗂 Field Descriptions

Field	Description
`event`	Always `"order_updated"`
`event_time`	Timestamp when the status update occurred
`branch_id`	ID of the branch that owns this order
`payload.order_id`	ID of the order being updated
`payload.status`	New status of the order — one of `accepted`, `rejected`, `cancelled`, `prepared`

🔄 Status Types

Status	Meaning
`accepted`	Order was accepted by the merchant
`rejected`	Order was rejected by the merchant
`cancelled`	Order was canceled by the merchant or system
`prepared`	Order has been prepared and is ready

📡 Webhook Delivery

Blend pushes this JSON to the delivery partner’s webhook URL
Delivery app must return 200 OK on successful receipt
Optionally, Blend may retry on failures

✅ Notes

Status updates help sync Blend’s internal state with delivery platforms
order_id should match the order previously sent in the order_created event
Delivery apps should process updates immediately to reflect order progress to couriers or customers