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

# Smile

> Connect Maple to your Smile POS system

Connect Maple directly to your Smile POS system for seamless order processing.

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

## Prerequisites

Before starting, ensure you have:

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

## Setup Process

<Steps>
  <Step title="Start KYC Verification">Submit business verification documents</Step>

  <Step title="Complete Gravity Onboarding">
    Smile uses Gravity as its payment processor. During onboarding, Maple connects your Smile account to Gravity for
    payment processing. This step must be completed before orders can be submitted to Smile.
  </Step>

  <Step title="Connect Smile Account">Authorize Maple to access your Smile system</Step>
  <Step title="Configure Locations">Select which locations to enable</Step>
  <Step title="Menu Sync">Verify menu imported correctly</Step>
  <Step title="Test Integration">Place test orders to verify setup</Step>
</Steps>

## KYC Requirements

Same as other integrated POS systems:

* Business registration documents
* EIN or Tax ID letter
* Owner's government-issued ID
* Bank statement or voided check

## Payment Processing

<Warning>
  Smile requires all orders to be paid before they are submitted to the POS. Pay-in-store is not supported with Smile.
</Warning>

Smile uses **Gravity** as its payment provider. When a customer places an order:

1. Customer receives a payment link via SMS
2. Customer pays through the Gravity-powered checkout page
3. Once payment is confirmed, the order is submitted to Smile
4. The order appears in your Smile POS with payment already applied

If Gravity onboarding is not complete, orders cannot be submitted to Smile. Ensure the onboarding process has fully completed before going live.

## Menu Synchronization

Your Smile menu syncs to Maple via webhooks:

* All menu items and prices
* Modifiers and options
* Categories and organization
* Real-time availability updates

<Tip>
  Menu sync is webhook-based, so updates from Smile may take a few moments to appear in Maple. If your menu doesn't
  appear after setup, wait a few minutes for the webhook to process.
</Tip>

## Order Management

Maple orders appear in Smile as:

* Source: "Maple - Phone" or "Maple - SMS"
* Standard Smile orders
* Full reporting integration

## Troubleshooting

<AccordionGroup>
  <Accordion title="Orders not submitting to Smile">
    Verify that Gravity onboarding is complete. Smile requires payment via Gravity before order submission. Check the
    Maple dashboard for any onboarding errors.
  </Accordion>

  <Accordion title="Menu not appearing after setup">
    Menu sync uses webhooks and may take a few minutes. If the menu still doesn't appear after 10 minutes, contact Maple
    support to trigger a manual sync.
  </Accordion>

  <Accordion title="Payment link not working">
    Ensure Gravity onboarding is fully complete. If the customer sees an error on the payment page, the Gravity
    connection may need to be re-established.
  </Accordion>
</AccordionGroup>

## Support

For Smile-specific issues, contact your Smile representative.
For Maple integration support, text +1 929 543 0229.

## Next Steps

* [Configure Payment Methods](/orders/config/payment-methods)
* [Test Your Integration](/quickstart)