Skip to content

Order Creation Flow

Integration flow for the process of creating a new order and state transitions until the order is fulfilled.

Creation Flow

  1. Partner application creates a new order using POST /v1/orders.

  2. When the user accepts the order (can be automatically accepted), the Public API sends an order status update webhook event containing status ORDER_ACCEPTED.

  3. (Optional) When the user marks the order as ready to pick up, the Public API sends an order status update webhook event containing status ORDER_READY_TO_PICK_UP.

  4. Partner application updates the order status to PREPARED using POST /v1/orders/{orderId}/status.

  5. (Optional) When the user marks that the order was handed off, either to a courier or to the customer. The Public API then sends an order status update webhook event containing ORDER_HANDED_OFF.

  6. Partner application updates the order status to FULFILLED using POST /v1/orders/{orderId}/status.