Point of Sale Integration

Display live menu prices and data on your digital signage by connecting to Toast POS or custom data feeds.

Overview

Data Sources allow you to pull live pricing and menu information into your designs. You can connect:

• Toast POS (Multi-Location) - Connect via OAuth to access all your restaurant locations
• Toast POS (Single Location) - Direct connection using a Restaurant GUID
• Custom API - Connect to any JSON REST API

Adding a Data Source

1. From the Dashboard, find the Point of Sale section
2. Click the + Add Source button
3. Choose your source type:

Toast POS (Multi-Location)

Best for restaurants with multiple locations managed under one Toast account.

Setup Steps

1. Select Toast POS (Multi-Location) from the Add Source modal
2. Enter your Toast API credentials:

1. Click Connect
2. Once connected, you’ll see all your restaurant locations listed
3. Toggle on the locations you want to use in your designs

Selecting Menu Data

For each enabled location, you can configure which menu data to display:

1. Click Settings next to the connected Toast POS source
2. For each location, set the Data Path to point to the menu section you want
3. Common paths include:

Toast POS (Single Location)

For connecting to a single restaurant location directly.

Setup Steps

1. Select Toast POS (Single Location) from the Add Source modal
2. Enter a Source Name (e.g., “Miami Beach Location”)
3. Enter your Restaurant GUID - found in your Toast dashboard

1. Click Add
2. Click Test to verify the connection

Clover POS

Connect to Clover to display menu items and prices from your Clover inventory.

Prerequisites

• A Clover merchant account
• API access enabled for your account
• Your Merchant ID and an API token

Finding Your Credentials

1. Log in to your Clover Dashboard
2. Go to Account & Setup
3. Navigate to API Tokens
4. Create a new token or copy an existing one
5. Your Merchant ID is displayed in the dashboard URL or in Account & Setup

Setup Steps

1. Select Clover POS from the Add Source modal
2. Enter a Source Name (e.g., "Downtown Clover")
3. Enter your Merchant ID
4. Enter your API Key (token from the Clover Dashboard)

1. Click Add
2. The system will fetch your menu items and categories

What Gets Imported

Clover imports the following data for each item:

Troubleshooting Clover

Square POS

Connect to Square to display catalog items, prices, and images from your Square account.

Prerequisites

• A Square merchant account
• Access to the Square Developer Dashboard
• An access token with catalog read permissions

Generating an Access Token

1. Go to the Square Developer Dashboard (developer.squareup.com)
2. Create or select an application
3. Navigate to Credentials
4. Copy your Access Token (Production or Sandbox)

Note: Production tokens only work with live data. Use Sandbox tokens for testing.

Setup Steps

1. Select Square POS from the Add Source modal
2. Enter a Source Name (e.g., "Main Store")
3. Enter your Access Token
4. Optionally enter a Location ID to filter by specific location (leave blank for all)

1. Click Add
2. The system will fetch your catalog items

What Gets Imported

Square imports the following data for each catalog item:

Troubleshooting Square

Custom API

Connect to any JSON REST API to display custom data.

Setup Steps

1. Select Custom API from the Add Source modal
2. Enter a Source Name
3. Enter the full API URL (must return JSON)

1. Click Add
2. Click Test to verify the connection works

API Requirements

Your API must: - Return valid JSON - Be accessible from Cloudflare’s servers - Support HTTPS (recommended)

Using Data Sources in Designs

Once connected, use your data sources in the design editor:

1. Open a design
2. Add a Text Box
3. In the properties panel, select your Data Source
4. Choose the Field to display (e.g., price, name, description)
5. Set the Format (currency, number, text)

Troubleshooting

“Testing…” stuck or Error status

• Verify your credentials are correct
• Check the API URL is accessible
• For Toast, ensure your API keys have the correct permissions

Data not updating

• Data refreshes when the display page loads
• For real-time updates, set up a refresh interval in your display software

Connection works but no data shows

• Check the Data Path is pointing to valid data
• Use the browser console to inspect the API response
• Verify the field name matches your data structure

Best Practices

1. Test before going live - Always verify connections in the editor preview
2. Use descriptive names - Name sources by location for easy identification
3. Monitor connections - Check the dashboard periodically for any connection errors