> ## 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

<Tabs>
  <Tab title="Maple Fleet (DSP)" icon="truck">
    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
    * Delivery fees and tips are handled through Maple

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

  <Tab title="Bring Your Own Fleet (BYOF)" icon="user-group">
    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 default delivery fee for all BYOF orders
    * Define delivery zones to control your coverage area
    * Optionally accept tips on delivery orders

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

  <Tab title="Hybrid" icon="arrows-split-up-and-left">
    Combine BYOF for nearby deliveries with the DSP network for longer-distance orders or overflow.

    **How it works:**

    * Define BYOF zones for areas your drivers cover
    * Orders outside your BYOF zones automatically route to the DSP network
    * Seamless fallback when your fleet is unavailable

    **Best for:** Restaurants that want to handle nearby deliveries in-house while expanding their delivery radius.
  </Tab>
</Tabs>

## Setting up delivery

<Steps>
  <Step title="Enable delivery">
    Navigate to the delivery settings in your Maple dashboard and select your delivery model (Maple Fleet or BYOF).
  </Step>

  <Step title="Configure delivery zones">
    Define the geographic areas where you offer delivery. You can create polygon zones (custom shapes) or circle zones
    (radius-based).
  </Step>

  <Step title="Set fees and minimums">
    Configure delivery fees, minimum order amounts, and estimated delivery times for each zone.
  </Step>

  <Step title="Test delivery">
    Place a test delivery order to verify zone coverage, fee calculation, and order routing.
  </Step>
</Steps>

## Delivery zones

Delivery zones define where your restaurant can deliver. Each zone has its own fee, minimum order amount, and estimated delivery time.

### 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.

<Info>
  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.
</Info>

### Zone settings

For each delivery zone, configure:

| Setting            | Description                                                |
| ------------------ | ---------------------------------------------------------- |
| **Delivery fee**   | Flat fee charged to the customer for delivery              |
| **Minimum order**  | Orders below this amount cannot be placed for delivery     |
| **Estimated time** | Estimated delivery time shown to customers during ordering |
| **Zone priority**  | When zones overlap, higher-priority zones take precedence  |

<Info>
  You can create multiple zones with different fees and minimums. For example, a lower fee for nearby areas and a higher
  fee for farther zones.
</Info>

## 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. Cash and pay-in-store are not available for delivery orders.
</Warning>

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 based on the customer's delivery address and your zone configuration.

<Warning>
  **Toast 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).
</Warning>

### 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

<Steps>
  <Step title="Customer places order">
    Customer calls or texts Maple and requests delivery. The AI collects their delivery address.
  </Step>

  <Step title="Address validation">
    Maple checks if the address falls within your delivery zones and calculates the delivery fee.
  </Step>

  <Step title="Order confirmation">
    The AI confirms the order, delivery fee, and estimated delivery time with the customer.
  </Step>

  <Step title="Payment processing">Customer pays upfront via card. The delivery fee is included in the total.</Step>
  <Step title="Order sent to kitchen">The order is submitted to your POS system for preparation.</Step>

  <Step title="Driver dispatch">
    For Maple Fleet orders, a courier is assigned and dispatched automatically. For BYOF, your team handles dispatch.
  </Step>

  <Step title="Status updates">
    The customer receives SMS updates as the delivery progresses (driver assigned, picked up, on the way, delivered).
  </Step>
</Steps>

## Troubleshooting

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="Delivery fee showing incorrectly">
    Verify the fee settings for each delivery zone. If zones overlap, the higher-priority zone's fee is used.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

## Early access

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

<Card title="Request Maple Fleet access" icon="truck" href="mailto:aidan@maple.inc?subject=%5BCOMPANY%20NAME%5D%20-%20Maple%20Delivery%20Early%20Access">
  Email us to get started with Maple Fleet delivery
</Card>

## Next Steps

<CardGroup cols={2}>
  <Card title="Configure Payments" icon="credit-card" href="/orders/config/payment-methods">
    Set up payment processing
  </Card>

  <Card title="Menu Management" icon="utensils" href="/orders/config/menu-management">
    Manage your menu
  </Card>

  <Card title="Orders Overview" icon="cart-shopping" href="/orders/overview">
    Return to orders overview
  </Card>

  <Card title="Go Live" icon="badge-check" href="/going-live">
    Launch your Maple AI
  </Card>
</CardGroup>