How to Set Up EleksCava Shopify Sales Display

Step 1: Open Apps and Sales Channels

First, navigate to your Shopify app settings:

1. Log in to your Shopify Admin dashboard
2. Click Settings in the bottom-left corner
3. Select Apps and sales channels
4. Click Develop apps (you may need to enable developer preview first)

Step 2: Create a Legacy Custom App

Now create a new app for EleksCava:

1. Click Create a legacy custom app
2. Enter an app name (e.g., EleksCava Sales Display)
3. Click Create app

Step 3: Configure Admin API Integration

Next, enable the Admin API for your app:

1. Open the Configuration tab
2. Find Admin API integration
3. Click Configure

Step 4: Enable Order Reading Permissions

EleksCava needs permission to read your order data:

1. Scroll down to the Orders section
2. Check the box for read_orders
3. Click Save in the top-right corner

This is the only permission EleksCava needs. It cannot modify your orders or access other sensitive data.

Step 5: Install the App

Before Shopify generates an access token, you must install the app:

1. Go back to the Overview tab
2. Click Install app
3. Confirm the installation in the popup dialog

Step 6: Reveal and Copy Your Access Token

Now retrieve your Admin API access token:

1. Navigate to the API credentials tab
2. Find Admin API access token
3. Click Reveal token once
4. Immediately copy and save this token — Shopify will never show it again!

Step 7: Note Your Store Domain

Finally, record your store information:

• Shop Domain: your-store.myshopify.com (found in your browser's address bar)
• Access Token: The shpat_xxxxx... token you just copied

Shopify also displays API key and API secret key below the access token. These are not required for EleksCava's basic functionality.

Step 1: Connect to the EleksCava Hotspot

1. Open Wi-Fi settings on your phone or computer
2. Look for a network named EleksCava-XXXX (XXXX is your device's unique ID)
3. Connect to this network (no password required)

Step 2: Open the Configuration Page

1. Open any web browser
2. Go to `http://192.168.4.1`
3. Alternatively, scan the QR code shown on the device screen

Step 3: Connect to Your Wi-Fi Network

1. Click Scan to search for nearby networks
2. Select your Wi-Fi network from the list
3. Enter your Wi-Fi password
4. Click Connect

Step 4: Verify Connection

When successfully connected:

• Screen shows "Connected" with your device's new IP address
• RGB LED turns solid green
• Device plays a confirmation tone

Write down the IP address — you'll need it for the next section.

Step 1: Access the Device Configuration Page

1. Ensure your phone/computer is on the same Wi-Fi network as EleksCava
2. Open a browser and enter the device's IP address (e.g., http://192.168.1.105)
3. Click Configure or navigate to the Shopify settings section

Step 2: Enter Your Shopify Credentials

Fill in the following fields:

Step 3: Test the Connection

1. Click Test Connection
2. Wait a few seconds for the result
3. You should see "Connection successful" if everything is correct

If you see an error, check the FAQ section below.

Step 4: Save and Start Displaying Sales

1. Click Save to store your configuration
2. The device will automatically fetch your sales data
3. Your e-ink display will update to show today's sales and orders

Why does "Test Connection" fail with HTTP 401 error?

Cause: The access token is invalid or doesn't have the correct permissions.

Solution:

1. Verify you copied the Admin API access token (starts with shpat_)
2. Make sure you didn't accidentally copy the API key or API secret instead
3. Confirm the app has read_orders permission enabled
4. Check that the app is properly installed (Step 5)

Why won't my device connect to Wi-Fi?

Possible causes and solutions:

Why does the display show $0 sales when I have orders?

This can happen for several reasons:

1. Timezone mismatch — EleksCava uses your Shopify store's timezone. If your store is set to a different timezone, "today" might not match your local time.
2. Order status filtering — Only orders with "paid" financial status are counted. Pending or refunded orders are excluded.
3. Sync delay — Wait for the next poll interval (check your configured refresh rate).

How do I reset my EleksCava device?

Press and hold the A and C buttons simultaneously for 10 seconds. The device will:

• Clear all saved Wi-Fi credentials
• Clear Shopify configuration
• Restart in AP mode for fresh setup

What do the buttons do?

How often does the display update?

The display refreshes based on your configured Poll Interval (default: 60 seconds). The e-ink screen only redraws when new data is received, which helps conserve power.