DoorDash Checkout API Interface (0.1.6)

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"
}