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

# POS Troubleshooting

> Solutions for POS integration issues

Troubleshooting guides for each POS integration.

## Toast issues

### Common problems

* **API rate limits**: Space out menu syncs
* **Location mismatch**: Verify location IDs
* **Menu visibility**: Check Toast menu settings
* **Payment processing**: Confirm Toast Payments enabled

### Toast support

* Toast Help Center: help.toasttab.com
* Toast Support: 617-297-1005

## Square issues

### Common problems

* **OAuth expiration**: Reauthorize connection
* **Catalog sync**: Check Square catalog
* **Modifier groups**: Verify modifier setup
* **Location settings**: Confirm correct location

### Square support

* Square Seller Community: sellercommunity.square.com
* Square Support: 1-855-700-6000

## Clover issues

### Common problems

* **API token invalid**: Clover uses OAuth tokens that refresh automatically. If you see token errors, try re-authorizing the Maple app in your Clover dashboard under **More Tools > Maple**.
* **Inventory sync**: Enable inventory tracking
* **Tax calculation**: Verify tax settings
* **Employee permissions**: Check API access

<Tip>
  Clover tokens refresh automatically in the background. If you revoke or regenerate tokens manually in Clover, you will
  need to re-authorize Maple from your Clover dashboard.
</Tip>

### Clover support

* Clover Help: help.clover.com
* Clover Support: 1-855-853-8340

## SpotOn issues

### Common problems

* **OAuth expiration**: Reauthorize connection from the dashboard
* **Menu sync delays**: Wait 5-10 minutes after menu changes
* **Location mapping**: Verify locations are correctly mapped
* **Payment failures**: Check CyberSource configuration

### SpotOn support

* Contact your SpotOn representative

## Smile issues

### Common problems

* **Orders not submitting to POS**: Smile requires payment via Gravity before orders can be submitted. Verify that Gravity onboarding is complete in your Maple dashboard.
* **Menu not appearing**: Smile menu sync is webhook-based. Wait a few minutes after connecting. If the menu still doesn't appear, contact Maple support.
* **Payment link errors**: If customers see errors on the payment page, the Gravity payment connection may need to be re-established. Check the onboarding status in the dashboard.
* **Missing item or modifier**: If the POS rejects an order due to a missing item or modifier, the menu may be out of sync. Trigger a manual menu refresh from the Maple dashboard.
* **Pay-in-store not available**: Smile does not support pay-in-store orders. All orders must be paid via the payment link before submission.

### Smile support

* Contact your Smile representative
* Maple integration support: text +1 929 543 0229

## SkyTab issues

### Common problems

* **Orders not appearing in POS**: Verify that the SkyTab installation is complete and the location is provisioned. Check the installation status in the Maple dashboard.
* **Payment processing errors**: SkyTab uses Shift4 for payment processing. Ensure Shift4 onboarding is complete and the payment link is functional.
* **Installation request stuck**: If the SkyTab installation request shows as pending, the Shift4 marketplace provisioning may still be in progress. Contact Maple support if it persists beyond 24 hours.
* **Menu sync issues**: SkyTab menus sync automatically. Allow up to 5 minutes for changes to propagate. If items are still outdated, trigger a manual sync from the dashboard.
* **Multi-location setup**: Each location requires its own SkyTab installation. Ensure each location has a unique merchant ID and has completed provisioning.
* **Pay-in-store not available**: SkyTab does not support pay-in-store orders. All orders must be paid via the Shift4 payment link before submission.

### SkyTab support

* SkyTab Help: support.skytab.com
* Shift4 Support: 1-888-276-2108
* Maple integration support: text +1 929 543 0229

## NCR Aloha issues

### Common problems

* **Menu sync delays**: Wait 10 minutes, check Aloha settings
* **Order routing**: Verify site configuration
* **Payment issues**: Check processor settings

### NCR support

* Contact your NCR representative

## NCR Voyix issues

### Common problems

* **API credentials**: Verify credentials are current
* **Menu import**: Check for complex modifier groups
* **Site ID**: Confirm correct Aloha Essentials site ID

### NCR support

* Contact your NCR representative

## Quantic issues

### Common problems

* **Multi-location**: Map locations correctly
* **Menu variations**: Set regional menus
* **API limits**: Check rate limits
* **Reporting delays**: Allow processing time

### Quantic support

* Contact your Quantic representative

## Tray issues

### Common problems

* **Credential validation**: Verify API credentials are correct and current
* **Menu sections**: Check that sections are published in Tray
* **Order submission**: Verify order format matches Tray requirements
* **Option groups**: Confirm modifier groups are syncing correctly

### Tray support

* Contact your Tray representative

## Chowbus issues

### Common problems

* **Credential issues**: Verify API credentials are correct
* **Menu translations**: Check that English item names are present
* **Category sync**: Verify categories are published
* **Order cancellation**: Some orders may not be cancellable once in preparation

### Chowbus support

* Contact your Chowbus representative

## Manual setup issues

### Common problems

* **Order notifications**: Check email/SMS settings
* **Menu organization**: Review categories
* **Payment setup**: Verify processing account
* **86'd items**: Update availability regularly

## Getting help

1. Check POS-specific documentation
2. Review integration logs in the Maple dashboard
3. Test with a simple order
4. Contact Maple support: text +1 929 543 0229
5. Engage POS vendor support
