Welcome to Drive's payment integration platform. Using this API, you can leverage our payment processing and checkout flow, along with order creation, order tracking, SaaS capabilities, and payment reporting.

Requirements:

• Store must be an existing store on DoorDash Marketplace
• Items passed in must reflect menu items existing on Marketplace store
• Must pass consumer email to us for storing Stripe profile on DoorDash's end

Here is the typical flow:

1. Once items on external end are ready for checkout, request an order_session_id by passing those items and prices, along with consumer data, delivery data, to our API.
2. Request a secure HTML checkout page to open in a webview on your app using the order_session_id from the previous step.
3. When consumer finished checkout flow, the order should either be successfully created or an error will be returned.
4. The delivery is executed.

A delivery is created in a scheduled state with the event "delivery_created". The end state is either "delivered" or "cancelled". Notable events will change delivery state and/or dasher state.

• Interface is REST-based
• POST data is application/json
• Request and response HTTP header “Content-type” is always “application/json”
• We use normal HTTP status codes

You will have to replace ${apiKey} curl -H "Authorization: Bearer ${apikey}" -v https://api.doordash.com/drive/v1/... with your specific API key. If you need an api key, contact [email protected].

Please retry all 50x response status codes as the error could be transient. We recommend up to 3 retries with some exponential backoff delay between requests.

If you need updates on various stages of a delivery, please provide us with a url endpoint that you would like to receive webhook events. The webhook events we send to your endpoint will have an Authorization header with value Bearer {API_KEY}, while {API_KEY} is the api key we provided you.

Currently, we send out the following events:

• delivery_created: We accepted your order and a delivery has been created for it.

• delivery_created: This event will occur once, after the delivery is created.

{
  "external_order_id": "1234-abcd",
  "event_category": "delivery_created",
  "tracking_url": "https://www.doordash.com/XXX",
  "created_at": "2021-02-01T02:01:00.000Z"
}