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

<Info>SpotOn integration requires KYC verification, which typically takes 2-3 business days.</Info>

## Prerequisites

Before starting, ensure you have:

* ✅ Admin access to SpotOn
* ✅ Maple Voice Core configured
* ✅ Business documentation for KYC
* ✅ Bank account information

## Setup Process

<Steps>
  <Step title="Start KYC Verification">Submit business verification documents to enable payment processing.</Step>

  <Step title="Connect SpotOn Account">
    Authorize Maple to access your SpotOn system through OAuth. You'll be redirected to SpotOn to approve the
    connection.
  </Step>

  <Step title="Select Locations">Choose which SpotOn locations to enable for Maple ordering.</Step>

  <Step title="Menu Sync">
    Your SpotOn menu syncs automatically. Verify that items, modifiers, and prices imported correctly.
  </Step>

  <Step title="Test Integration">Place test orders to verify the full order flow from call to kitchen.</Step>
</Steps>

## KYC Requirements

Submit the following documents:

* Business registration (LLC, Corp, etc.)
* EIN or Tax ID letter
* Owner's government-issued ID
* Bank statement or voided check

<Warning>KYC processing takes 2-3 business days. Start this immediately to avoid delays.</Warning>

## Connecting SpotOn

SpotOn uses OAuth for authorization:

1. Go to **Orders Module** → **POS Integration**
2. Select **SpotOn** from the available options
3. Click **Connect SpotOn Account**
4. You'll be redirected to SpotOn's login page
5. Enter your SpotOn credentials and approve Maple's access
6. You'll be redirected back to the Maple dashboard

<Tip>
  You need SpotOn admin permissions to authorize the integration. Contact your SpotOn administrator if you don't have
  access.
</Tip>

## 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. Changes sync to Maple automatically.</Note>

## Payment Processing

SpotOn integration uses CyberSource for payment processing:

* Credit/debit card support
* Secure tokenized transactions
* PCI-compliant processing

<Warning>Pay-in-store is not available for SpotOn orders. All orders require upfront card payment.</Warning>

### Payment Rules

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

## Order Management

Maple orders appear in SpotOn as:

* Source: "Maple - Phone" or "Maple - SMS"
* 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

<AccordionGroup>
  <Accordion title="Menu items not syncing">
    * Verify items are active in SpotOn - Check visibility settings - Wait 5-10 minutes for sync to complete - Contact
      support if issues persist
  </Accordion>

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

  <Accordion title="Payment failures">
    * Verify payment settings are configured correctly - Check processor status - Review decline reasons in the
      dashboard - Confirm customer card details are valid
  </Accordion>

  <Accordion title="OAuth connection expired">
    * Re-authorize the SpotOn connection from the dashboard - Go to **Orders Module** → **POS Integration** →
      **Reconnect**
  </Accordion>
</AccordionGroup>

## Support

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

## Next Steps

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

  <Card title="Configure Delivery" icon="truck" href="/orders/config/delivery">
    Set up delivery zones and fees
  </Card>
</CardGroup>