How to Set Up EleksCava Shopify Sales Display

Step 1: Create an App in Shopify Dev Dashboard

Start from Shopify's Dev Dashboard. The app must belong to the same Shopify organization as the store you want to connect:

1. Open Shopify Admin → Settings → Apps and sales channels
2. Follow Shopify's link to Dev Dashboard, or open Dev Dashboard directly
3. Click Apps → Create app
4. Choose Start from Dev Dashboard and enter a clear private name, such as EleksCava Sales Display
5. Use this flow for stores you own. Apps for other merchants should use Shopify's normal app authentication flow instead.

Step 2: Configure Admin API Scopes and Release a Version

Create or edit an app version, then grant only the scopes the device needs:

1. Open the app's Versions page
2. Set the Admin API access scope read_orders
3. Optional: add read_all_orders only if you need all-time counters that include orders older than Shopify's default order history window
4. Save and Release the app version

Step 3: Install the App to Your Store

The client credentials grant only works after the app is installed on the target store:

1. Open the app's Overview or Home page
2. Click Install app
3. Select the Shopify store you want to connect
4. Confirm that read_orders is listed, then approve the installation

Step 4: Copy Client ID and Client Secret

New Dev Dashboard apps do not show a permanent Admin API token in Shopify Admin. Instead, the app credentials request short-lived Admin API tokens when needed:

1. Open the app's Settings page in Dev Dashboard
2. Copy the Client ID from the Credentials section
3. Use the reveal or copy button for Client Secret only when you are ready to configure the device

Do not copy the App automation token. Tokens that start with `atkn_` are for Shopify CLI / CI deployment and cannot read store Admin API data.

Step 5: Choose the Device Authentication Mode

Firmware v1.2.1 supports two modes. Use Auto Refresh unless you have a specific reason not to store the Client Secret on the device:

1. Auto Refresh (recommended): enter Shop Domain, Client ID, and Client Secret in the device portal. The device exchanges them for an Admin API access token, stores the runtime token, and refreshes it before expiry or after a 401 response.
2. Manual Token (fallback): run the token exchange on your computer, paste the returned access_token into the device portal, and repeat the script when the token expires.
3. Do not paste an App automation token. Tokens that start with atkn_ are for Shopify CLI / deployment automation and cannot read store Admin API data.

Step 6: Manual Token Fallback Scripts

Skip this step when using Auto Refresh. If you choose Manual Token, exchange the client credentials on your computer and paste only the returned `access_token` into EleksCava:

1. SHOP is only the part before .myshopify.com
2. Use grant_type=client_credentials
3. A successful response contains access_token, scope, and expires_in
4. Confirm the returned scope includes read_orders

SHOP="your-store-subdomain"
CLIENT_ID="paste_client_id_here"
read -rs "CLIENT_SECRET?Client Secret: "
echo

HTTP_CODE=$(curl -sS -w "%{http_code}" \
  -o /tmp/shopify-token.json \
  -X POST "https://${SHOP}.myshopify.com/admin/oauth/access_token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -H "Accept: application/json" \
  -d "grant_type=client_credentials" \
  --data-urlencode "client_id=${CLIENT_ID}" \
  --data-urlencode "client_secret=${CLIENT_SECRET}")

echo "HTTP ${HTTP_CODE}"
python3 - <<'PY'
import json
from pathlib import Path

path = Path("/tmp/shopify-token.json")
raw = path.read_text()
print(raw)

data = json.loads(raw)
token = data.get("access_token")
scopes = set((data.get("scope") or "").replace(" ", "").split(","))

print()
print("access_token:", token)
print("scope:", data.get("scope"))
print("expires_in:", data.get("expires_in"))

if not token:
    raise SystemExit("No access_token returned. Check HTTP code and error text.")
if "read_orders" not in scopes:
    raise SystemExit("Missing read_orders scope. Update app scopes and reinstall.")
PY

$Shop = "your-store-subdomain"
$ClientId = "paste_client_id_here"
$ClientSecretSecure = Read-Host "Client Secret" -AsSecureString
$Bstr = [Runtime.InteropServices.Marshal]::SecureStringToBSTR($ClientSecretSecure)

try {
    $ClientSecret = [Runtime.InteropServices.Marshal]::PtrToStringBSTR($Bstr)
    $Body = @{
        grant_type = "client_credentials"
        client_id = $ClientId
        client_secret = $ClientSecret
    }

    $Response = Invoke-RestMethod `
        -Method Post `
        -Uri "https://$Shop.myshopify.com/admin/oauth/access_token" `
        -ContentType "application/x-www-form-urlencoded" `
        -Body $Body

    Write-Host "HTTP 200"
    $Response | ConvertTo-Json
    $Response | ConvertTo-Json | Set-Content "$env:TEMP\shopify-token.json"

    if (-not $Response.access_token) {
        throw "No access_token returned."
    }
    $Scopes = ($Response.scope -replace " ", "") -split ","
    if ($Scopes -notcontains "read_orders") {
        throw "Missing read_orders scope. Update app scopes and reinstall."
    }
}
finally {
    if ($Bstr -ne [IntPtr]::Zero) {
        [Runtime.InteropServices.Marshal]::ZeroFreeBSTR($Bstr)
    }
}

Step 7: Prepare the Values for the EleksCava Portal

Record the exact values you will enter into the device configuration portal:

• Shop Domain: your-store.myshopify.com (the full .myshopify.com domain, not the admin URL)
• Auto Refresh: Client ID and Client Secret from Dev Dashboard app Settings
• Manual Token: Only the access_token returned by the script above

The device portal never returns the saved Client Secret through its config API. If the secret is exposed, rotate it in the Shopify Dev Dashboard.

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 Shopify Settings

In the Shopify section of the portal, fill in the fields for your selected authentication mode:

Step 3: Test the Connection

1. Click Test Connection
2. Wait a few seconds for the result
3. Auto Refresh will request a fresh token during the test if needed
4. You should see Connected and read_orders OK if everything is correct
5. If the portal warns about the scope check, fix the app scopes before saving

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. For Auto Refresh, the Client Secret field is cleared after saving and shown as configured
3. The device will automatically fetch your sales data
4. Your E-Ink display will update to show today's sales and orders

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

Cause: The token is invalid, expired, or was created from credentials that no longer match the installed app.

Solution:

1. For Auto Refresh, re-copy the current Client ID and Client Secret from Dev Dashboard app Settings
2. For Manual Token, run the client credentials script again and paste the new access_token
3. Do not paste an App automation token that starts with atkn_
4. Confirm the app has read_orders permission enabled
5. Check that the app is installed on the target store

Why do I get HTTP 404 or Not Found when running the manual script?

Possible causes and solutions:

Why does the device reject an App automation token?

App automation tokens usually start with atkn_. They are for Shopify CLI / deployment automation and cannot call store Admin API endpoints. EleksCava needs either Auto Refresh credentials or a real Admin API access_token returned by the client credentials grant.

Why does Manual Token work today but fail tomorrow?

Client credentials grant tokens expire after about 24 hours. Use Auto Refresh for normal daily use, or rerun the manual script and paste the new access_token when the old token expires.

When do I need read_all_orders?

read_orders is enough for today's sales and recent order counters. Add read_all_orders only if you need all-time counters that include older order history, and only after Shopify allows that scope for your app.

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.