Skip to main content
As an order progresses through Fire (accepted, in preparation, ready, dispatched, etc.), Fire sends order.status_changed events to your webhook endpoint.

​
Flow

Fire emits order.status_changed → Your system receives event → Your system acts on it

​
Event payload

{
  "event": "order.status_changed",
  "data": {
    "fire_order_id": "fire_order_abc",
    "external_order_id": "uber_order_9876",
    "channel_id": "channel_abc123",
    "status": "in_preparation",
    "previous_status": "accepted",
    "updated_at": "2025-01-15T14:35:00Z"
  }
}

​
Order statuses

StatusDescription
receivedOrder injected successfully into Fire
acceptedRestaurant accepted the order
in_preparationKitchen started preparing the order
readyOrder is ready for pickup or dispatch
dispatchedHanded to the delivery person
deliveredDelivered to the customer
cancelledOrder was cancelled

​
Processing steps

1

Verify the signature

Validate X-Fire-Signature. See Authentication.
2

Acknowledge immediately

Return 200 OK before processing.
3

Look up the order

Use external_order_id to find the order in your system.
4

Act on the status change

Notify aggregators, update your database, trigger workflows — whatever your integration requires.

​
Cancellations

If status is cancelled, act on it promptly. If your system relays orders to aggregators, some require cancellation confirmation within a short time window.