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

> [!NOTE]
>
> Smile is offered to Gravity merchants. Taking card payments needs your Gravity payment onboarding to be complete.

## Prerequisites

Before starting, ensure you have:

- ✅ A Smile POS on a Gravity merchant account, and your Smile MID
- ✅ A Maple Pro plan, which includes phone ordering and POS integrations

## Setup Process

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

2. ### Enter Your Smile MID
   Enter your Smile MID in Maple to link your Smile location

3. ### Menu Sync
   Verify menu imported correctly

4. ### Test Integration
   Place test orders to verify setup

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

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

When Maple asks for your menu, Smile sends it back to Maple:

- All menu items and prices
- Modifiers and options
- Categories and organization
- Item availability

> [!TIP]
>
> Smile does not send menu and availability changes as you make them. They reach Maple when the menu resyncs, which you can start with **Resync Menu** on the Menus page. If your menu doesn’t appear after setup, wait a few minutes for Smile to send it.

## Order Management

Maple orders appear in Smile as:

- Standard Smile orders, with the Gravity payment already applied
- Full reporting integration

Maple cannot cancel an order once it reaches Smile; cancel it in Smile.

## Troubleshooting

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

**Menu not appearing after setup**

Smile sends the menu back a few minutes after Maple asks for it. If the menu still doesn’t appear after 10 minutes, click **Resync Menu** on the Menus page or contact Maple support.

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

## Support

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

## Next Steps

- [Configure Payment Methods](https://docs.maple.inc/orders/config/payment-methods.md)
- [Test Your Integration](https://docs.maple.inc/quickstart.md)