Importing from Loyverse
If you're moving from Loyverse, this guide brings your stores, items, customers, and team into LaundryVerse in one step. The sync itself usually takes under two minutes; classifying items and a quick spot-check adds another five.
Before you start
You'll need:
- A Loyverse account with API access — any plan works, though see the receipt history note below
- (Recommended) A rough idea of which items are drop-off services (Wash & Fold, Comforter Wash) versus self-service (coin-op wash/dry). You'll classify them in a wizard after sync.
If you don't have a Loyverse account, skip this guide and head to Account Setup — pick the Use LaundryVerse POS path instead.
Already have past sales on paper, a notebook, or a spreadsheet? You can bring them in from a CSV after setup, so your reports and customer history start complete. See Importing Past Sales.
What gets imported
When you connect Loyverse, we pull this data in order:
| # | Step | Notes |
|---|---|---|
| 1 | Merchant profile | Used to verify the key |
| 2 | Stores | Names, addresses, hours |
| 3 | Categories | With colors |
| 4 | Items | Active items only, with variants and prices |
| 5 | Customers | With contact info |
| 6 | Employees | Names only — PINs are set inside LaundryVerse |
| 7 | Payment types | Custom names preserved |
| 8 | Discounts | Percent and fixed rules |
Not imported:
- Receipt history older than the sync window — receipts backfill in the background once you're in the dashboard. Free Loyverse plans cap at the last 30 days; paid plans bring full history.
- Service Tags — Loyverse doesn't have this concept. You'll classify items as Drop-Off vs Self-Service in the wizard right after sync.
- Loyalty points history — point balances stay in Loyverse.
- Archived items — only active items come over. Unarchive in Loyverse Back Office and re-sync if you need them.
1. Sign up and pick the import path
Start at laundryverse.app/auth/signup — see Account Setup for the signup details. After verifying your email, you'll land on the "How do you manage sales?" screen.
Click Import from Loyverse.
2. Connect your Loyverse account
You have two ways to authenticate.
Option A — Connect with Loyverse (one click)
Click Connect with Loyverse. You'll bounce to Loyverse's login page, sign in there, approve LaundryVerse's access, and land straight on the syncing screen.
Option B — Paste an API key
If OAuth gives you trouble, generate an API key in Loyverse:
- Open Loyverse Back Office → Integrations → Access tokens.
- Click + Add Access Token.
- Give it a name (e.g.
LaundryVerse) and save. - Copy the token Loyverse shows you.
- Back in LaundryVerse, paste it into the Loyverse API Key field and click Connect & Sync.
The walkthrough above uses the API key option for clarity on camera. The Connect with Loyverse button is one click in real use and lands in the same place.
3. Watch the sync
You'll land on Setting up your account. Each of the 8 steps from the table above ticks off with a count — items (47), customers (128), and so on.
If you're on Loyverse's free plan, you'll see a notice that receipt history is limited to 30 days — click Continue to proceed.
Don't close the tab. The sync runs while you wait; closing the tab won't lose progress, but you'll need to re-open the dashboard to keep going.
4. Classify your items
Next, the Classify Your Items wizard. This is the one piece Loyverse doesn't carry over.
- Step 1 — Drop-Off: tick every item that's a staff-handled laundry service (Wash & Fold, Comforter Wash, Specialty Laundry). Receipts with these items auto-create orders on the POS Order Board.
- Step 2 — Self-Service: tick items for customer machine use (Self-Service Wash, Self-Service Dry, coin-op).
- Everything you don't tick stays as Unclassified.
Click Continue to Dashboard when you're done.
Service tags only affect whether receipts auto-create board orders. Nothing breaks if items are unclassified — you can set tags anytime from Catalog → Items. Hit Skip for now on step 1 to defer the whole wizard.
5. Verify your import
You'll land on Dashboard → Getting Started. Before continuing setup, spot-check three places from the sidebar:
- Catalog → Items — scan for items that should be there. If something's missing, it was probably archived in Loyverse.
- Sales → Customers — confirm contact info came through. Visit counts and total spent restart at zero — those track LaundryVerse activity going forward.
- Operations → Stores — confirm store name, address, and operating hours. Geo-fence settings are LaundryVerse-only; set those here.
Common issues
Items missing or showing the wrong price
Only active (non-archived) items are imported during onboarding. If something's missing, check Loyverse Back Office — it was likely archived. You can add the missing item directly in LaundryVerse from Catalog → Items, or unarchive it in Loyverse and re-sync your Loyverse data yourself. You can also contact support for a hand.
Receipt history hasn't appeared yet
- Free Loyverse plans cap at ~30 days.
- Backfill runs in the background after onboarding. A banner on the dashboard tracks progress — give it 5–10 minutes for the first batch.
Categories look empty
Categories are imported with items. If a category shows zero items, its items were archived in Loyverse. You can delete the empty category from Catalog → Items → Category Manager.
Sync failed mid-import
Contact support and we'll re-run the sync from our side. Have your account email ready so we can find the tenant.
I picked the wrong path during onboarding
Switching from "Use LaundryVerse POS" to "Import from Loyverse" (or vice versa) isn't a self-serve option — contact support and we'll reset your tenant.
What's next?
Your data is in. Now wire up the POS so you can ring up your first order:
- Setting Up the POS — generate a store code, install the app, log in with a PIN, and open your first shift
- Setting Up the Printer — connect a receipt printer (skip if you're going paperless to start)
- Your First Order — walk through the full order flow end-to-end
Stuck? Email [email protected] — the founder reads every message.