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

# SpotOn

> Connect Maple to your SpotOn POS system for automatic order processing

Connect Maple directly to your SpotOn POS system for seamless order processing. Orders taken via phone or SMS appear instantly in your SpotOn system.

> [!NOTE]
>
> Card payments run through CyberSource and are set up with your SpotOn connection, so there is no separate Stripe verification.

Maple works with both SpotOn point-of-sale systems, Restaurant POS (RPOS) and Express, and with the TSYS and Worldpay payment systems.

## Prerequisites

Before starting, ensure you have:

- ✅ Admin access to SpotOn
- ✅ A SpotOn Dashboard user for each location you connect ([how to create one](https://help.spoton.com/space/SK/4354441244/Dashboard+Users+%7C+SpotOn+Merchant+Dashboard))
- ✅ A Maple Pro plan, which includes phone ordering and POS integrations

## Setup Process

1. ### Connect SpotOn Account

   Authorize Maple to access your SpotOn system through OAuth. You’ll be redirected to SpotOn to approve the connection.

2. ### Select Location
   Choose the SpotOn location to connect to this Maple location.

3. ### Choose Menus

   Choose which SpotOn menus Maple should sync, then activate the integration. Verify that items, modifiers, and prices imported correctly.

4. ### Test Integration
   Place test orders to verify the full order flow from call to kitchen.

## Connecting SpotOn

SpotOn uses OAuth for authorization:

1. Click **Orders** in the sidebar, then **Continue: Select POS** on the **Finish setting up Orders** card (or open the location’s settings and go to **Integrations**)

   ![Finish setting up Orders card with Continue: Connect POS](https://docs.maple.inc/images/help/spoton-connection-guide/connectspoton.png)

2. Choose **SpotOn**, then click **Continue With SpotOn**

3. Click **Authorize SpotOn**

4. You’ll be redirected to SpotOn’s login page

5. Sign in with your SpotOn **Dashboard** credentials (not your SpotOn POS login) and approve Maple’s access

   ![Authorize SpotOn](https://docs.maple.inc/images/help/spoton-connection-guide/authorizespoton.png)

6. On **Choose which SpotOn menu(s) to sync**, select your menus and click **Continue**. One primary menu is recommended unless your menus are split by daypart. You can change this later under **Integrations** → **SpotOn Connection** → **Edit Selection**.

   ![Choose which SpotOn menus to sync](https://docs.maple.inc/images/help/spoton-connection-guide/menuspoton.png)

7. Wait 5–10 minutes for the menu to sync, then check items and prices on the **Menus** page

8. Once SpotOn shows **Connected**, tell your onboarding specialist. They check payment processing, help you click **Confirm Enable Orders**, and run a live test call with you.

> [!TIP]
>
> You need SpotOn admin permissions to authorize the integration. Contact your SpotOn administrator if you don’t have access.

## Menu Synchronization

Your SpotOn menu syncs automatically to Maple:

- ✅ All menu items and prices
- ✅ Modifiers and option groups
- ✅ Categories and organization
- ✅ Item availability updates
- ✅ Price changes

> [!NOTE]
>
> Menu changes should be made in SpotOn. New items, modifiers and out-of-stock updates sync to Maple automatically after you update the menu on the POS.

## Payment Processing

SpotOn integration uses CyberSource for payment processing:

- Credit/debit card support
- Secure tokenized transactions
- PCI-compliant processing
- Cards are charged in US dollars

> [!WARNING]
>
> Pay-in-store is not available for SpotOn orders. Every order is paid upfront by card through a payment link Maple texts to the caller, so Maple orders appear in SpotOn as closed orders.

### Payment Rules

| Order Type   | Payment Options       |
| ------------ | --------------------- |
| **Pickup**   | Card required upfront |
| **Delivery** | Card required upfront |

SpotOn needs a full delivery address (street, city, state and ZIP code). Delivery orders with an incomplete address are rejected.

## Order Management

Maple orders appear in SpotOn as:

- Source: Maple
- Standard SpotOn order format
- Full reporting integration
- Kitchen display compatible

### Order Flow

1. Customer places order via Maple (phone or SMS)
2. Order appears in SpotOn immediately
3. Kitchen receives the order via display or printer
4. Standard SpotOn workflow applies

## Multi-Location Support

For restaurants with multiple locations:

- Configure each location separately
- Different menus per location
- Location-specific pricing
- Centralized reporting available

## Troubleshooting

**Menu items not syncing**

- Verify items are active in SpotOn
- Check visibility settings
- Wait 5-10 minutes for sync to complete
- Missing items usually come from the menu setup on your POS, so contact SpotOn Support

**Nothing happens after Continue With SpotOn**

A popup blocker stopped the SpotOn window. Allow popups for Maple in your browser and click **Continue With SpotOn** again.

**Sign-in fails, or your location isn't listed**

Sign in with your SpotOn Dashboard account, not your SpotOn POS login. If your location isn’t listed, the email you signed in with has no Dashboard user for that location. Create one for each location ([guide](https://help.spoton.com/space/SK/4354441244/Dashboard+Users+%7C+SpotOn+Merchant+Dashboard)), then try again.

**Orders not appearing in SpotOn**

- Confirm the integration is active in the Maple dashboard
- Check that SpotOn is online
- Verify the correct location is selected
- Review error logs in the dashboard

**Payment failures**

- Verify payment settings are configured correctly
- Check processor status
- Review decline reasons in the dashboard
- Confirm customer card details are valid

**OAuth connection expired**

- Open the location’s settings, go to **Integrations**, and choose **Reconnect** next to SpotOn
- Approve Maple’s access again

## Support

- **SpotOn Support**: Contact your SpotOn representative
- **Maple Support**: Text +1 929 543 0229

## Next Steps

- [Configure Payments](https://docs.maple.inc/orders/config/payment-methods.md): Set up payment processing
- [Configure Delivery](https://docs.maple.inc/orders/config/delivery.md): Set up delivery zones and fees