Order status notifications

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

Status	Description
`received`	Order injected successfully into Fire
`accepted`	Restaurant accepted the order
`in_preparation`	Kitchen started preparing the order
`ready`	Order is ready for pickup or dispatch
`dispatched`	Handed to the delivery person
`delivered`	Delivered to the customer
`cancelled`	Order was cancelled

Processing steps

Verify the signature

Validate X-Fire-Signature. See Authentication.

Acknowledge immediately

Return 200 OK before processing.

Look up the order

Use external_order_id to find the order in your system.

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.

Get started

Configuration

Working with events

Guides

Order status notifications

Flow

Event payload

Order statuses

Processing steps

Cancellations

​Flow

​Event payload

​Order statuses

​Processing steps

​Cancellations

Flow

Event payload

Order statuses

Processing steps

Cancellations