Connect your Loyverse account

Connecting links your Loyverse account so the two systems can sync. You only do this once. Connecting is owner-only.

Before you start

• You need an access token from your Loyverse account. Generate one in your Loyverse Back Office, under Integrations → Access Tokens. (Loyverse’s own help has the exact steps and screen — it’s the token your apps use to read and write your account.)
• Swann Retail works with any number of stores on your Loyverse account — a single store or several. After you connect, you tell Swann Retail which Swann location each store belongs to; see Map your stores to locations.

Connect

1. In Swann Retail, go to Settings → Loyverse sync.
2. Paste your Loyverse access token and turn the connection on.
3. Swann Retail checks the token straight away — it reads your Loyverse account to confirm it works. If the token is wrong, expired, or can’t read your account, the connection is rejected and nothing is saved; generate a fresh token and try again.

Once connected, map your stores to locations so Swann Retail knows where each store’s sales and stock belong — nothing syncs until at least one store is mapped. Then the one-time import brings your existing Loyverse catalog across, and ongoing two-way sync takes over from there.

Connection status

Status	What it means
Never connected	You haven’t linked Loyverse yet.
Connected	The token is valid and sync is running.
Invalid token	Your token was revoked or replaced, so sync has stopped. Paste a fresh token to reconnect — it also shows in Sync health as “Reconnect needed”.
Disabled	The connection is turned off. Sync is paused until you turn it back on.

Keeping your token safe

• Only the last few digits of your token are ever shown back to you — the full token is never displayed again after you save it.
• If you revoke or replace the token in Loyverse, sync will start to fail — you’ll see the errors in Sync health. Paste a fresh token under Settings → Loyverse sync to get going again.