PUT
{orders_api_base_url}
/
orders
/
accept
/
{
  "success": true,
  "message": "<string>",
  "order_id": "<string>",
  "status": "<string>",
  "estimated_ready_time": "<string>",
  "fulfillment_id": "<string>"
}
This endpoint allows stores to formally accept incoming orders from delivery platforms like DoorDash, UberEats, and Grub Hub. Accepting an order initiates the fulfillment workflow and notifies the delivery platform that the order is being processed.
Once an order is accepted, it cannot be rejected through normal processes. Use the cancel order endpoint if you need to cancel after acceptance.

​
Request Body

​
store_id
string
required
The unique identifier of the store accepting the order
​
order_id
string
required
The unique identifier of the order to accept
​
estimated_ready_time
string
Estimated time when the order will be ready for pickup/delivery (ISO 8601 format)
​
special_notes
string
Additional notes about the order preparation or any special considerations

​
Response

​
success
boolean
Indicates whether the order was successfully accepted
​
message
string
Confirmation message or error details
​
order_id
string
The accepted order’s unique identifier
​
status
string
New order status after acceptance (typically “accepted” or “in_progress”)
​
estimated_ready_time
string
Confirmed estimated ready time (if provided)
​
fulfillment_id
string
Unique identifier for the fulfillment tracking record created

​
Request Example

{
  "store_id": "449235c1-3d04-4519-998b-40d2a621e5e0",
  "order_id": "35d18f08-6d54-421d-9476-8cef629111bc",
  "estimated_ready_time": "2024-01-15T14:30:00Z",
  "special_notes": "Extra care required for fragile items"
}

​
Response Example

{
  "success": true,
  "message": "Order successfully accepted and fulfillment initiated",
  "order_id": "35d18f08-6d54-421d-9476-8cef629111bc",
  "status": "accepted",
  "estimated_ready_time": "2024-01-15T14:30:00Z",
  "fulfillment_id": "f60a1ebf-c9fd-4c5a-b25f-db5f59e03851"
}
Time Sensitive: Orders typically have acceptance windows (usually 10-15 minutes). Failing to accept within this window may result in automatic cancellation by the delivery platform.
Best Practice: Always provide realistic estimated_ready_time values. Accurate timing improves customer satisfaction and delivery platform ratings.
If you don’t provide an estimated_ready_time, the system will calculate one based on your store’s historical preparation times and current order volume.

​
Error Responses