> ## Documentation Index
> Fetch the complete documentation index at: https://docs.maple.inc/llms.txt
> Use this file to discover all available pages before exploring further.

# Delivery Configuration

> Set up delivery zones, fees, and providers for your restaurant

Maple supports delivery orders with flexible configuration for zones, fees, and driver management. You can use a third-party delivery service provider (DSP) network, your own fleet of drivers (BYOF), or a combination of both.

## Delivery modes

- **Maple Fleet (DSP)**

  Maple Fleet connects your restaurant to a network of delivery service providers (DSPs) including DoorDash Drive and Uber Direct. Maple handles courier assignment, tracking, and status updates automatically.

  **How it works:**

  - Customer places a delivery order through Maple
  - Maple requests a delivery quote from the DSP network
  - A courier is assigned and dispatched to your restaurant
  - The customer receives real-time status updates via SMS
  - The delivery price is dynamic, based on distance
  - Delivery fees and tips are handled through Maple

  **Typical delivery range:**

  - Dense urban areas: 3–7 miles
  - Typical suburban areas: 5–15 miles
  - Suburban and rural areas with fewer couriers: 15–20+ miles

  The actual range depends on how many couriers are active nearby at the time of the order.

  **Best for:** Restaurants without their own delivery drivers, or as overflow capacity during peak times.

- **Bring Your Own Fleet (BYOF)**

  Use your own delivery drivers. Maple handles order-taking and sends delivery details to your team.

  **How it works:**

  - Customer places a delivery order through Maple
  - The order is sent to your POS with delivery details
  - Your team manages driver assignment and dispatch
  - You define your own delivery zones and fees

  **Configuration options:**

  - Set a delivery fee for each delivery zone
  - Define delivery zones to control your coverage area
  - Optionally accept tips on delivery orders

  On Toast, Maple uses the delivery fees you’ve set up in Toast (see [Toast](/orders/pos/toast#what-to-set-up-in-toast-web)).

  **Best for:** Restaurants with existing delivery staff who want to keep using their own drivers.

## Setting up delivery

1. ### Enable delivery

   In your location settings, open **Delivery Settings** and click **Enable Deliveries**, then choose **Maple’s Fleet** or **Bring Your Own Fleet**. Make sure **Delivery Orders** is on in your agent’s **Orders** settings so the AI can take delivery orders.

2. ### Configure delivery zones

   Define the geographic areas where you offer delivery. You can create polygon zones (custom shapes) or circle zones (radius-based).

3. ### Set fees

   Set a priority for each zone. For BYOF, also set each zone’s delivery fee and choose whether customers can tip your drivers. For Maple Fleet, the delivery price is dynamic, based on distance.

4. ### Test delivery

   Place a test delivery order to verify zone coverage, fee calculation, and order routing.

## Delivery zones

Delivery zones define where your restaurant can deliver. Each zone has its own priority and, for BYOF, its own delivery fee.

### Zone types

| Zone Type   | Description                         | Best for                                       |
| ----------- | ----------------------------------- | ---------------------------------------------- |
| **Polygon** | Custom-drawn shape on a map         | Precise coverage areas, city boundaries        |
| **Circle**  | Radius-based zone around your store | Simple setups, even coverage in all directions |

**Polygon zones** let you draw a freeform boundary on the map. Use these when your delivery area follows streets, highways, or other irregular boundaries.

**Circle zones** define a radius (in miles) centered on your store’s location. The system generates the boundary automatically — you only need to set the distance. Circle zones are useful when you want uniform coverage in all directions.

> [!NOTE]
>
> Both zone types work the same way during ordering. When a customer provides a delivery address, Maple checks whether it falls inside the zone boundary. For circle zones, the boundary is an approximation of the radius you set.

### Zone settings

For each delivery zone, configure:

| Setting           | Description                                                                                |
| ----------------- | ------------------------------------------------------------------------------------------ |
| **Delivery fee**  | BYOF: the price you set for delivery in this zone. Maple Fleet: dynamic, based on distance |
| **Zone name**     | A name for the zone, for example “Downtown Area”                                           |
| **Active**        | Turn a zone off to stop using it for deliveries                                            |
| **Zone priority** | When zones overlap, higher-priority zones take precedence                                  |

> [!NOTE]
>
> For BYOF, you can create multiple zones with different fees. For example, a lower fee for nearby areas and a higher fee for farther zones.

## Pickup instructions

If you use the Maple Fleet (DSP) network, you can provide pickup instructions for drivers. These instructions tell the courier where and how to pick up the order at your restaurant.

Navigate to your store’s delivery settings and enter pickup instructions in the text area. Examples:

- “Enter through the side door on Oak Street”
- “Ask for the online order at the front counter”
- “Ring the buzzer and say you’re picking up a delivery order”

## Payment for delivery orders

> [!WARNING]
>
> Delivery orders require card payment upfront, except when your own drivers deliver them — then the customer can pay on delivery, on POS systems that support pay in store. Maple Fleet deliveries always require upfront card payment.

Payment for delivery orders is processed through your configured payment provider (Stripe, Gravity, or Shift4) before the order is sent to your POS. The delivery fee is added to the order total automatically: your zone’s fee for BYOF, or a distance-based price for Maple Fleet.

> [!WARNING]
>
> **Toast locations on StreamOrders: pay-on-delivery requires cash enabled in StreamOrders.** If you accept pay-on-delivery (pay-in-store) orders routed to Toast through StreamOrders, you must enable **cash** as an accepted payment method for delivery in StreamOrders. Otherwise Toast rejects the order (`decision_failed` / “payment method declined”) and it never reaches the kitchen. See [StreamOrders: accepted payment methods](https://help.streamorders.com/en/articles/13441016).

### Delivery fee billing

How the delivery fee is settled depends on your payment processor:

- **Stripe merchants:** Maple takes the delivery fee directly.
- **Non-Stripe merchants:** The delivery fee is added as a line item on the order, so you collect it at checkout, and Maple then invoices it back. This is a net-zero passthrough — not an extra charge.

## Delivery order flow

1. ### Customer places order

   Customer calls or texts Maple and requests delivery. The AI collects their delivery address.

2. ### Address validation

   Maple checks if the address falls within your delivery zones and calculates the delivery fee.

3. ### Order confirmation

   The AI confirms the order, delivery fee, and estimated delivery time with the customer.

4. ### Payment processing
   Customer pays upfront via card. The delivery fee is included in the total.

5. ### Order sent to kitchen
   The order is submitted to your POS system for preparation.

6. ### Driver dispatch

   For Maple Fleet orders, a courier is assigned and dispatched automatically. For BYOF, your team handles dispatch.

7. ### Status updates

   The customer receives SMS updates as the delivery progresses (driver assigned, picked up, on the way, delivered).

## Troubleshooting

**Delivery not available for a customer's address**

The customer’s address may be outside your configured delivery zones. Check your zone boundaries in the dashboard and expand them if needed. The AI will inform the customer and offer pickup as an alternative.

**Delivery fee showing incorrectly**

For BYOF, verify the fee settings for each delivery zone. If zones overlap, the higher-priority zone’s fee is used. Maple Fleet prices are based on distance.

**Maple Fleet orders not being assigned a courier**

Ensure your Maple Fleet setup is complete and that the delivery territory is configured for your area. During high-demand periods, courier availability may be limited. Contact Maple support if assignment is consistently failing.

## Early access

Interested in Maple Fleet delivery? We’re working with select partners.

[**Request Maple Fleet access**](mailto:aidan@maple.inc?subject=%5BCOMPANY%20NAME%5D%20-%20Maple%20Delivery%20Early%20Access)

[Email us to get started with Maple Fleet delivery](mailto:aidan@maple.inc?subject=%5BCOMPANY%20NAME%5D%20-%20Maple%20Delivery%20Early%20Access)

## Next Steps

- [Configure Payments](https://docs.maple.inc/orders/config/payment-methods.md): Set up payment processing
- [Menu Management](https://docs.maple.inc/orders/config/menu-management.md): Manage your menu
- [Orders Overview](https://docs.maple.inc/orders/overview.md): Return to orders overview
- [Go Live](https://docs.maple.inc/going-live.md): Launch your Maple AI