Docs · Setup

Set up Lightspeed Restaurant K-Series

This is an approved-partner integration, not a credential a restaurant owner can create inside Hoozh. Keep the Setup card visible, but do not enable Connect until Hoozh has production client credentials.

1

Get approved API access

Apply through the Lightspeed K-Series Developer Portal guide. Lightspeed currently reserves these APIs for approved partners and approved merchants.

2

Request the production V2 client

Register this exact HTTPS redirect URI and request only the scopes Hoozh uses:

Redirect URI

https://hoozh.app/api/integrations/lightspeed/callback
financial-apiitemsoffline_access

New client IDs begin with devp-v2. Hoozh detects that prefix and uses Lightspeed's current production V2 OAuth endpoints. Legacy V1 client IDs remain compatible.

3

Store the credentials in Railway

Add the two production values below. Do not paste secrets into a support ticket, commit, or chat.

LIGHTSPEED_CLIENT_ID=production client ID
LIGHTSPEED_CLIENT_SECRET=production client secret

Leave LIGHTSPEED_AUTH_BASE blank for automatic V2/V1 selection. LIGHTSPEED_API_BASE defaults to https://api.lsk.lightspeed.app. Override either only for a Lightspeed-issued trial environment.

4

Connect and prove a real sale

Open POS connections, choose Connect Lightspeed, authorize the merchant, and select the correct business location. Hoozh imports the location's catalog and closed sales.

“Authorized” means sign-in completed. The card changes to “Working” only after Hoozh receives a real, non-test sale.
← Back to POS connections