Troubleshooting guides for each POS integration.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.
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
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
- Check POS-specific documentation
- Review integration logs in the Maple dashboard
- Test with a simple order
- Contact Maple support: text +1 929 543 0229
- Engage POS vendor support