Order Payload
Every new order arrives as an OrderCreate webhook. The request body wraps an order object:
{
"event": {
"type": "OrderCreate",
"status": "NEW"
},
"order": {
"id": "order-001"
}
}
All amounts are integers in cents unless noted, for example 1999 is $19.99. Keep the order id: you need it to confirm the order and for every later update.
Top-level order fields
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier for the order. |
consumer | object | The customer who placed the order. See Consumer object. |
store | object | The store fulfilling the order. See Store object. |
subtotal | integer | Order subtotal in cents, before tax, tips, and fees. |
tax | integer | Tax amount in cents. |
estimated_pickup_time | string | ISO 8601 UTC timestamp for when DoorDash expects the order to be picked up. |
is_pickup | boolean | true when the customer picks up the order. |
categories | array | The ordered items, grouped by category. See Categories object. |
is_tax_remitted_by_doordash | boolean | true when DoorDash remits tax for the order, for example in Marketplace Facilitator states. |
tax_amount_remitted_by_doordash | integer | Tax amount in cents that DoorDash remits, when is_tax_remitted_by_doordash is true. |
commission_type | string | The type of customer account that placed the order: regular or dashpass. |
delivery_short_code | string | Short code the Dasher uses to identify the order at pickup. |
fulfillment_type | string | How the order is fulfilled: dx_delivery (Dasher delivery), pickup (customer pickup), or mx_fleet_delivery (Self Delivery). |
merchant_tip_amount | integer | Tip in cents for your store staff. |
tip_amount | integer | Delivery tip the customer added, in cents. 0 for pickup orders. |
experience | string | Where the order was placed: DOORDASH, CAVIAR, STOREFRONT, WHITE_LABELED, DOORDASH_CHECKOUT, or ANY_EXPERIENCE. |
is_plastic_ware_option_selected | boolean | true when the customer asked for plasticware or utensils. |
custom_fee | array | Custom fees on the order, such as a bag fee. Only present when a custom fee applies. See Bag Fees. |
Example order
The following example is a pickup order for one wireless mouse with a 2-year protection plan, plus a bag fee.
{
"id": "order-001",
"consumer": {
"id": 123456,
"first_name": "Jane",
"last_name": "D",
"phone": "+18552228111"
},
"store": {
"merchant_supplied_id": "store-123",
"provider_type": "my_provider"
},
"subtotal": 2499,
"tax": 263,
"estimated_pickup_time": "2025-06-14T19:00:00Z",
"is_pickup": true,
"categories": [
{
"name": "Electronics",
"merchant_supplied_id": "cat-001",
"items": [
{
"name": "Wireless Mouse",
"merchant_supplied_id": "item-001",
"price": 1999,
"quantity": 1,
"extras": [
{
"name": "Protection Plan",
"merchant_supplied_id": "extra-001",
"options": [
{
"name": "2-Year Protection Plan",
"merchant_supplied_id": "opt-001",
"price": 500,
"quantity": 1
}
]
}
],
"special_instructions": "Color: Black",
"line_item_id": "line-001"
}
]
}
],
"is_tax_remitted_by_doordash": true,
"tax_amount_remitted_by_doordash": 263,
"commission_type": "regular",
"fulfillment_type": "pickup",
"merchant_tip_amount": 200,
"tip_amount": 0,
"experience": "DOORDASH",
"is_plastic_ware_option_selected": false,
"custom_fee": [
{
"type": "BAG_FEE",
"price": 30,
"tax": 5
}
]
}
Consumer object
Details about the customer who placed the order.
| Field | Type | Description |
|---|---|---|
id | integer (int64) | Unique identifier for the customer. Your system must support a 64-bit integer. |
first_name | string | Customer's first name. |
last_name | string | Customer's last name initial. |
email | string | A DoorDash support email address, not the customer's own email. |
phone | string | A DoorDash support phone number, unless the Masked Customer Phone Number feature is enabled for your store. |
Store object
The store fulfilling the order.
| Field | Type | Required | Description |
|---|---|---|---|
merchant_supplied_id | string | Yes | Your unique identifier for the store location. |
provider_type | string | Yes | Your integration's provider identifier, assigned by DoorDash or set up in the Developer Portal. |
Categories object
The categories array groups the ordered items the same way your catalog does.
| Field | Type | Description |
|---|---|---|
name | string | Display name of the category. |
merchant_supplied_id | string | Your unique identifier for the category. |
items | array | The items ordered in this category. See Items object. |
Items object
| Field | Type | Description |
|---|---|---|
name | string | Name of the item. |
merchant_supplied_id | string | Your unique identifier for the item. |
price | integer | Item price in cents, for example 1499 for $14.99. |
quantity | integer | Number of this item ordered. |
extras | array | Modifier groups the customer selected options from. See Extras object. |
consumer_name | string | For group orders, the first name of the person who ordered this item. |
special_instructions | string | The customer's instructions for this item, if your store allows them. |
line_item_id | string | Unique identifier for this line item. Use it when you adjust the order. |
Extras object
An extra is a modifier group, such as "Protection Plan". It has no price of its own: the price is on each option the customer selected.
| Field | Type | Description |
|---|---|---|
name | string | Name of the modifier group. |
merchant_supplied_id | string | Your unique identifier for the modifier group. |
options | array | The options the customer selected in this group. See Options object. |
Options object
An option is the specific choice inside an extra, such as "2-Year Protection Plan".
| Field | Type | Description |
|---|---|---|
name | string | Name of the option. |
merchant_supplied_id | string | Your unique identifier for the option. |
price | integer | Additional price in cents for this option. |
quantity | integer | Quantity of this option selected. |
extras | array | Nested modifier groups under this option, in the same shape as the Extras object. |
line_option_id | string | Unique identifier for this option line. |
Feature-specific fields
Orders can include more fields when a feature applies to the order, such as a promotion, Self Delivery, or SNAP/EBT payment. Those fields are documented with each feature:
| Feature | Fields | Documented in |
|---|---|---|
| Promotions and discounts | applied_discounts, applied_discounts_details, subtotal_for_tax, subtotal_tax_amount, subtotal_discount_funding_source, total_merchant_funded_discount_amount, and applied_item_discount_details on items | Receive Integrated Promo Data |
| Self Delivery | delivery_address, delivery_fee | Enable Self Delivery |
| Substitutions | substitution_preferences on items | Substitution Preferences and item instructions |
| SNAP/EBT | snap_amount on items | SNAP/EBT Order Data |
| Bag fees | custom_fee | Receive Bag Fees |