Skip to main content

Businesses and stores

API: Drive (classic)

This doc covers the Drive (classic) API. If you're using the Drive API, see the Drive business & store reference guide.

DoorDash Drive maintains a data model of businesses–a merchant that owns a collection of stores–and stores–individual locations from which deliveries are made. This data model helps our logistics platform optimize and route deliveries and helps ensure every delivery makes it to the right place. It also helps make your delivery requests shorter and easier by abstracting common information, like a store's pickup address and contact details, into a single ID that you can reference when creating a delivery. Finally, the business and store data model helps us structure the invoice you receive for deliveries to be easy to use and break out by merchant.

Concepts​

To understand the concepts of business & store, we'll use the example of a middleware provider that serves a variety of local restaurant groups. In this example, our middleware provider serves a merchant called Neighboorhood Deli that has 10 deli stores, named Neighboorhood Deli #1 through Neighboorhood Deli #10, as well as a merchant called Ariana's Tacos that only has a single location.

Business​

In non-technical terms, a business is a merchant or a brand. A business is some sort of entity–usually a legal business like a corporation, franchise, LLC, or similar–that owns a set of stores, usually under the same brand. In technical terms, a business in DoorDash's data model collects a set of stores under a given external_business_id. A business can have many stores or just one, but you must have at least one store under a business to create deliveries for that business.

In our middleware provider example, Neighborhood Deli and Ariana's Taco are businesses.

info

external_business_names are unique within your organization, so you cannot have more than one business with the same external_business_name.

Store​

A store represents a single location that makes deliveries: a restaurant, a storefront, a ghost kitchen, or any other location from which you wish to deliver goods. We use the metadata you provide about a store to ensure Dashers can quickly find your location and customers know where their delivery is coming from.

In our middleware provider example, Neighborhood Deli #1 through Neighborhood Deli #10, as well as Ariana's Tacos' single location, are stores.

info

external_store_ids are unique within each business, so you cannot have duplicate stores with the same external_store_id within a business. However, you can reuse an external_store_id across multiple businesses. For example, you might have external_store_id=1 for Neighborhood Deli #1 and for Ariana's Tacos' single location, because those two stores are children of different businesses.

Why you should create businesses and stores​

Improved delivery quality​

DoorDash uses Google Maps to resolve the pickup_address that you provide when you create a delivery. For some stores, especially stores in newly-mapped or newly-built locations, the Google Maps place ID for the address you provide can change over time, leading Dashers to go to the wrong location. Creating stores through the Store API allows a DoorDash operator to pin a store's location so that the Dasher appears at the right location every time.

Peace of mind​

If something goes wrong during the auto-onboarding process, a store might have food sitting on a table waiting to get delivered, which makes for a stressful experience trying to resolve the auto-onboarding issue before the food has to be remade. Creating stores through the Store API allows a merchant to be certain that a store has the right address, pickup instructions, billing information, and more, before any deliveries are made.

Clear invoices​

Creating businesses and stores through the Business & Store APIs helps DoorDash provide you the most accurate invoice for the deliveries made by each merchant and each store.

Better support experiences​

Creating stores through the Store API ensures that DoorDash Support can easily locate and troubleshoot deliveries when a merchant calls in.

If your merchants use the DoorDash Merchant Portal, it also ensures that a store operator can see all of their deliveries in one place in the portal. Merchant Portal access is not mandatory, but we recommend it as a tool to help merchants track and manage orders.

Access to leads from DoorDash marketing sites​

get.doordash.com ranks well in SEO and may be the first place your merchants land when they're seeking out a local delivery integration; the Business API and webhooks enable those leads to have a seamless onboarding experience so that more merchants convert.

Self-serve access to new delivery capabilities​

In the coming months, we'll be augmenting the Business & Store model with the ability for you to self-serve enable delivery capabilities that require additional configuration or an additional agreement with DoorDash, like alcohol deliveries and catering/large order deliveries.

Example business & store scenarios​

Merchant​

To understand how you might create your own business and stores, consider the example of a collection of sandwich shops all owned by a single restauranteur. In this example, you would first create a business, "Neighborhood Deli". Then, you would create all of the delis owned by Neighborhood Deli, say, "Neighborhood Deli #1" and "Neighborhood Deli #2". Now, whenever you want to make a delivery from Neighborhood Deli #2, you can pass the Neighborhood Deli external_business_name and Neighborhood Deli #2 external_store_id and DoorDash will use the address and store details that you entered when you created the business & store, so you don't have to pass this information with every request.

Platform/middleware provider​

Next, consider the example of a platform or a middleware provider that works with many merchants. In this example, you would create as many businesses–say, "Ariana's Tacos" and "Patrick's Pizza" and "Jordan's Mediterranean Bites"–and then create a store or stores underneath each business as needed. As in the deli example, whenever you want to make a delivery from Ariana's Tacos West Seattle, you can pass the Arian's Tacos external_business_name and Ariana's Tacos West Seattle external_store_id and DoorDash will use the address and store details that you entered when you created the business & store, so you don't have to pass this information with every request.

Next steps​

Now that you know about the concepts of businesses and stores, you can: