1. Invite, Manage and Remove Front-Desk Staff
Invite a verified email address, copy the single-use link and manage access without editing the database.
1
Owner: create the invitation
Open Settings and find Staff access. Enter the person's email and create an invitation. Copy and share its link yourself; CuratorUSA does not send an invitation email. Links expire after seven days.
2
Staff: verify and accept
Open the link, sign in or create a staff account, and verify the invited email. Select Accept staff access, then Open mall console. Signing up alone does not grant access.
3
Replace or cancel a link
Reissue an invitation if its link was lost or expired. Reissuing replaces the old link. Cancel an unwanted invitation before it is accepted.
4
Remove access
The owner can remove an active staff member in Settings. New API requests from that person's existing session are immediately denied for this mall. Their account and other mall memberships are retained.
โก Good to know- Staff can use the register, manage inventory/booths/vendors and view reports/statements. Owners retain staff administration, mall settings, Square connection, billing and settlement finalization.
- Use the invited email. Existing owner or vendor roles cannot be replaced by a staff invitation.
โ Why can't I accept a staff invitation?Check that you are signed in with the invited, verified email and are using the latest link. Expired, replaced, canceled or already-used links require a new invitation from the current owner.
2. Set Up Your Antique Mall Profile & Storefront Subdomain
Create your mall account, choose your custom storefront subdomain, add your business contact information, and publish your online storefront.
1
Create your Mall Operator account
Go to /auth?mode=signup, select '๐๏ธ I run an Antique Mall', enter your mall or co-op name, city, and 2-letter state code (e.g., OH), and sign up with email/password or Google.
๐ก Tip: Your 14-day free trial starts immediately โ no credit card is required to set up booths, tags, and vendors.
2
Complete your Mall Profile in Settings
Open โ๏ธ Settings โ Mall Profile. Enter your public phone number, street address, city, 2-letter state, and postal code for receipts, vendor statements, and your published storefront.
3
Customize your storefront subdomain
In the 'Storefront subdomain' field, enter a clean URL slug such as maple-street-antiques. Your unified mall storefront will live at https://maple-street-antiques.curatorusa.com.
4
Toggle 'Publish unified mall storefront' and Save
Keep 'Publish unified mall storefront' checked and click '๐พ Save mall profile'. Every available item with 'Published online' enabled will now appear on your public storefront.
โก Good to know- Want to practice first? On the Overview page (/dashboard), click '๐ฑ Seed Demo Mall' on a brand-new mall to populate sample booths, dealers, tagged items, and sales so your cashiers can practice.
- The public Antique Mall Directory (/malls) is researched separately from customer accounts. To suggest a listing or correction, email support@curatorusa.com with a public business website or tourism source.
โ Why does my storefront say 'not registered' or 'not published yet'?Open โ๏ธ Settings โ Mall Profile, confirm 'Publish unified mall storefront' is checked, and click Save mall profile.
3. Configure Commission Tiers, Card-Fee Pass-Through & Settlement Rules
Set your default mall commission percentage, optional price-bracket commission tiers (e.g. lower commission on high-ticket furniture), and credit-card processing fee pass-through.
1
Open the Settlement Policy panel
Navigate to โ๏ธ Settings and locate the '๐ Settlement Policy' card on the right column.
2
Set your default commission rate & settlement day
Enter your default commission percentage. The preferred settlement day is a reference value; it does not schedule statements. Review the settlement time zone before your first finalized run, after which it locks.
3
Add optional price-bracket commission tiers
If your mall charges a lower commission on high-ticket items, click '+ Add tier'. For example, set 'Up to $200.00 โ 10%' and 'Above $200.00 โ 6%'. CuratorUSA uses bracket pricing (the item's full price uses the rate of the bracket it falls into).
๐ก Tip: Individual dealers (like co-op members who work front-desk shifts) can still have their own custom commission override set on their Vendor record.
4
Configure credit-card fee pass-through
Check 'Pass card-processing fees through to vendors' if dealers pay the card swipe fee on card sales, and enter the percentage (e.g., 3%). Cash sales automatically carry $0.00 card fee.
5
Verify with the Live Example calculator & Save
Review the '๐งฎ Live example (card sale)' table at the bottom of the card to verify exact commission, card fee, and vendor net payouts on $25, $100, and $350 items, then click '๐พ Save settlement policy'.
โก Good to know- Every sale snapshots the exact commission and card-fee split at the moment the register rings it up, so changing your policy later never alters historical sales.
4. Add Booths, Showcases & Onboard Vendors with Invite Codes
Build your floor map of booths, locked glass showcases, and wall spaces, set monthly booth rent, create dealer records, and issue 8-character invite codes so vendors can log in.
1
Create your Vendors (Dealers) first
Go to ๐บ๏ธ Booths & Vendors. In the Vendors panel, enter the dealer's name, business name, email, phone and optional commission override, then choose Add vendor. Leave the override blank to use your mall's policy.
2
Copy and send the Vendor Invite Code
Each new vendor automatically receives an 8-character invite code (such as ABCD-2345). Use the copy icon in the Portal column, then share the code and sign-up link with the dealer yourself.
๐ก Tip: Once the vendor claims the code, the Portal column shows Claimed.
3
Create your Booths, Showcases & Wall Spaces
In the Booths panel, enter a short code (for example, A1), label, space type, monthly rent and assigned vendor, then choose Add booth.
4
Reassign or vacate a booth anytime
Click 'Edit' on any booth row to change its monthly rent, assign a new vendor, or set the vendor to 'โ Vacant โ' when a dealer moves out.
โก Good to know- Keep booth codes short and alphanumeric (like A1, A12, C3). Every item tag in that booth is automatically numbered with that prefix (e.g., A12-0001, A12-0002).
- A single vendor can be assigned to multiple spaces (for example, Floor Booth A1 plus Locked Showcase C1). Both rents will be itemized on their monthly statement.
5. Connect Square POS, OAuth2 Webhooks & Pair Square Terminals
Connect your mall's Square account, configure supported sale attribution and optional Terminal devices, and validate the full workflow before taking live payments.
1
Open the Square POS & OAuth panel
Go to โ๏ธ Settings โ '๐ฆ Square POS & OAuth' on the left column.
2
Connect via 1-Click Square OAuth (or Manual Token)
Select your environment (Production or Sandbox) and click '๐ Connect with Square OAuth' to authorize CuratorUSA with your Square merchant account. Alternatively, click '๐ Manual Token' to provide a Square Access Token, Location ID and Application ID. Use production credentials for live malls.
3
Verify your Webhook URL for automatic order splitting
In Square Developer Console, use the webhook URL and event list shown in Settings. The supported events are order.created, order.updated, payment.created, payment.updated, refund.created, refund.updated and terminal.checkout.updated. Use the matching environment and signature key.
๐ก Tip: Validate a completed supported order with your actual merchant, location and tag mapping. Review the attributed ledger lines; missing or ambiguous data must be resolved before relying on the workflow.
4
Pair your Square Terminal devices (optional)
Under '๐ Paired Square Terminals', enter a nickname (e.g., 'Front Counter') and the Square Device ID, then click '+ Add'. You can now send card checkouts directly from the CuratorUSA Register screen to that terminal.
5
Validate your configured Square workflow
A simulator is available only in the local QA environment. For a real mall, verify your merchant, location, signed webhook delivery, tag attribution and physical devices. Check uncertain payment attempts in Payment review before retrying.
โก Good to know- Supported confirmed Square orders and CuratorUSA register sales feed the mall ledger used for reporting and statements. Validate each payment method you plan to use.
6. Run the Front-Desk Register: Scan Barcodes, AI Paper Tag OCR & Process Sales
Ring up multi-vendor baskets by scanning QR/Code-128 tags, typing booth tag codes, or snapping a photo of a handwritten paper string tag with AI Vision OCR.
1
Scan a barcode/QR tag or type a tag code
Open ๐งพ Register. With the cursor in the top lookup bar, scan any CuratorUSA QR or Code-128 barcode tag with a USB scanner, or type a tag code like `A3-1` (which automatically normalizes to `A3-0001`) and press Enter. Exact matches drop straight into the basket.
2
Scan handwritten paper string tags with AI Vision OCR
Click Camera scan tag to use a laptop webcam, USB camera, phone or tablet camera. Allow camera access, choose the camera if more than one is connected, and take a photo. Review it, retake if needed, then choose Read tag from photo. Gemini Vision reads the Booth Code, Title, and Price. Upload tag photo is available if you already have a picture or camera access is unavailable.
๐ก Tip: If the tag matches an existing cataloged item, it adds it immediately. If it's an uncataloged booth item, review the Booth, Title, and Price in the confirmation bar, then click '+ Add' to create the item and add it to the sale.
3
Apply negotiated booth discounts / price overrides (if needed)
When a dealer approves a discount on an item (e.g., 10% off a $100 dresser), type the agreed sale price (`90.00`) into the 'Override $' box on that cart line. Commission and card-fee splits recalculate live.
4
Let the customer scan a payment QR code
Choose Customer QR payment and prepare the sale. Show the on-screen code to the customer. They scan it with their phone camera and pay on Square using their own card or wallet; they do not need a CuratorUSA account. Keep the cashier screen open for confirmation. Copy payment link is available if the customer needs the link another way.
5
Use Square POS on your iPhone or Android device
Install and sign in to Square Point of Sale using the mall's connected merchant and location. On the Mac, build the basket and choose Square POS app. Scan the cashier-only QR with your iPhone and sign in to CuratorUSA as owner or staff if prompted. The same held sale opens; check its total, then tap Prepare Square on this phone and Open Square on this device. Collect the card payment in Square and return to CuratorUSA. The Mac shows the receipt after verification. You can also run the entire register on the phone. Phone device IDs are not paired Square Terminals.
๐ก Tip: The application owner must register https://curatorusa.com/register under Square Developer Console โ Point of Sale API โ Web Callback URLs. A returned transaction must be verified with Square before inventory is marked sold. If payment is uncertain, check Payment review before charging again.
6
Choose the payment method and complete the sale
Choose Cash or Card (External Reader) to record a payment already collected, or a configured Square method to request payment. Cash/external records complete immediately. Square payments reserve items and remain pending until provider confirmation; uncertain payments should be checked in Payment review before taking any further payment.
7
Print the receipt or reverse a mistaken sale
After checkout, click '๐จ๏ธ Print receipt' for the customer. If a sale was rung up by mistake or returned before month-end settlement, find it under 'Today's Register Sales' and click 'โฉ Reverse' to void the ledger entry and return the item to 'Available' status.
โก Good to know- The Register groups basket lines by Booth & Vendor so the cashier can see every dealer's exact gross, commission, card fee, and net payout before pressing Complete Sale.
- Settled sales (already locked in a finalized month-end statement) are protected and cannot be reversed.
7. Close the Month: Run Vendor Settlements, Rent Netting & Payout Statements
Preview month-to-date dealer earnings, automatically deduct commissions, card fees, and monthly booth rent, finalize the monthly run, and print or export vendor payout statements.
1
Select the settlement period & preview live numbers
Open Settlements, choose a calendar month and click Generate draft settlement. The default is the previous month. Review gross sales, commission, card fees, monthly booth rent, adjustments and net payout. Months use the settlement time zone in Settings; new unsettled sales from earlier periods are included as carryover.
2
Review how booth rent netting works
Statements calculate gross minus commission, card fees and configured monthly booth rent, plus agreed adjustments. A negative net is shown as Vendor owes mall; it is not an automatic rent carry-forward or a money transfer. Monthly rent uses the booth assignments and rates at draft generation, with no automatic proration. Enter agreed credits or charges for mid-month changes.
3
Finalize & lock the monthly settlement run
After the period closes in the mall's settlement time zone, review the draft and click Finalize. Pending payments/refunds and changes since draft generation must be resolved first. Regenerate stale drafts. Finalization locks included ledger entries and publishes statements to the vendor portal; it does not send money.
4
Inspect individual vendor statements & print
Open a finalized run to review vendor totals. Use its CSV export or print a vendor statement for your records. Reports show individual sales and fee splits. Review any earlier unsettled sales shown as carryover.
5
Record external vendor payments
Pay positive balances and arrange collection of negative balances outside CuratorUSA. After all external payments and collections for the run are complete, choose Record external payouts and optionally enter a bank batch or check reference. This records the entire run; it does not initiate ACH, send checks or pay vendors individually.
โก Good to know- Once a ledger entry is locked in a settlement run, re-running a settlement for overlapping dates will never double-count those sales.
8. Export Sales Ledgers & Customize Your Storefront Theme
Filter recorded sales by date and vendor, export CSVs for your bookkeeper, and style your mall storefront with the available themes.
1
Filter your Sales Ledger in Reports
Open Reports. Choose a date preset or a custom start/end date. Owners and staff can filter by vendor. Review the summary totals and vendor breakdown; vendor accounts see their own sales only.
2
Export a CSV for bookkeeping or accountant review
Click 'โฌ๏ธ Export CSV' to download every matching ledger line with sale ID, timestamp, booth code, tag code, vendor name, gross, commission, card fee, vendor net, payment method, and settlement run ID.
3
Style your console and storefront with Stitch Themes
Open โ๏ธ Settings โ '๐จ Storefront Stitch Theme'. Pick one of the curated presets (The Glass Museum, Neon Heritage, or Tactile Archive) or type a prompt like 'Cozy walnut and forest sage green' and click 'โก Generate AI theme'.
โก Good to know- Vendors have their own '๐ My Sales' tab that uses the same report view, automatically scoped to only their booths and items โ and they can export their own CSVs for taxes.
9. Create Item Drafts with AI Vision Intake
Add up to four clear item photos and generate a draft title, description, category and suggested price. Review the details yourself, then save the item to allocate its booth tag code.
1
Open AI Intake & select the Booth
Tap ๐ธ AI Intake (or '๐ธ Add Item' in the Vendor Portal). Choose the target Booth from the dropdown at the top. If you're a vendor with one booth, it is pre-selected for you.
2
Snap or upload up to 4 item photos
Choose Use camera for a laptop webcam, USB camera, phone or tablet camera. Allow access, select a camera if needed, take a photo and review it. Choose Retake or Use photo to add it. Alternatively, choose Upload photos for existing images. Add up to 4 views (front, maker's mark, patina/condition details). The camera stops after capture or when its window closes.
3
Click 'โจ Analyze with Gemini Vision'
CuratorUSA analyzes the photos and automatically fills in the Item Title, Category, Era badge, rich collector's description, and a suggested retail price.
๐ก Tip: Type a quick hint in the Title box before clicking Analyze (e.g., 'Griswold #8') if a maker's mark is hard to see in the photo.
4
Review price, toggle Online Storefront & Save
Review the title, condition, description and price. Enable Publish to mall online storefront if shoppers should see the item, then save it. The live storefront currently supports browsing and contacting the mall; live online card checkout is not enabled.
5
Write the Tag Code or print a QR/Barcode label
A confirmation card displays the item's sequentially allocated Tag Code (for example, `A3-0014`). Write that code on your paper string tag, or click '๐ท๏ธ Print QR / Barcode Tag' to print a scannable label immediately.
โก Good to know- Use Capture Next Item to continue cataloging. Review each generated draft, including condition, attribution and pricing, before saving it.
10. Print QR & Code-128 Barcode Hangtags, Thermal Labels & Blank Fill-In Tags
Print machine-scannable QR + 1D Code-128 barcode hangtags on standard 8.5"ร11" letter sheets, Zebra/Rollo 2.25"ร1.25" labels, or Dymo 30252 3.5"ร1.125" labels โ including blank fill-in tags.
1
Open the QR & Barcode Tag Studio
Click ๐ท๏ธ Tags (or '๐ท๏ธ Print Tags' in the Vendor Portal).
2
Choose your Label or Sheet Format
Use the 'Label / Sheet Format' dropdown to select your paper or label stock:
โข ๐ Letter Sheet (8.5"ร11" ยท 12 perforated hangtags per page)
โข ๐ท๏ธ Thermal Roll 2.25"ร1.25" (Zebra / Rollo jewelry & hangtag label)
โข ๐ท๏ธ Thermal Roll 3.5"ร1.125" (Dymo 30252 / Rollo address label)
3
Select cataloged items to print
Filter by Booth or search by tag code/title, then click items to toggle them into your print batch (or click 'Select all filtered').
4
Optional: Add Blank Fill-In Tags for handwritten pricing
Prefer writing descriptions and prices by hand at your booth? Select your booth and enter a number (1โ48) in '+ Blank Fill-In Tags'. CuratorUSA prints pre-numbered booth tags with a QR code, barcode, and write-in lines for Item & Price.
5
Click '๐จ๏ธ Print / Save PDF'
Click the Print button. In your browser's print dialog, set Scale to '100%' (or 'Actual Size') and uncheck 'Headers and footers' for crisp barcode alignment.
โก Good to know- Every CuratorUSA tag includes both a 2D QR code (`cusa1:{mallId}:{boothId}:{itemId}:{priceCents}`) and a 1D Code-128B barcode of the tag code (`A1-0001`), so both 1D laser scanners and 2D/camera scanners read them instantly.
โ My thermal labels are cutting off or spanning two labels.In your browser print dialog, make sure 'Paper Size' matches your thermal roll (2.25"ร1.25" or 3.5"ร1.125"), Margins are set to 'None' or 'Minimum', and Scale is '100%'.
11. Join Your Mall & Claim Your Booth Vendor Invite Code
Use the 8-character invite code from your antique mall manager to link your login to your booth(s), view live sales, and catalog items from your phone.
1
Get your 8-character Invite Code from your mall
Ask your antique mall manager for your CuratorUSA Vendor Invite Code (it looks like `ABCD-2345`).
2
Create your Vendor account (or sign in)
Go to /auth?mode=signup&type=vendor, choose '๐งบ I rent a Booth (Vendor)', paste your Invite Code into the box, and create your account with email/password or Google.
๐ก Tip: Already created an account without entering the code? Just sign in โ the console will show an '๐งบ I rent a booth' card where you can paste your invite code anytime.
3
Explore your '๐ My Booth' Dashboard
Once linked, your dashboard shows your assigned booth(s), monthly rent, month-to-date gross sales, your net earnings after commission and card fees, and a live feed of your recently sold items.
โก Good to know- Rent booths in more than one CuratorUSA antique mall? Use the mall switcher dropdown in the top-right navigation bar to jump between buildings with one login.
12. Manage Your Booth Inventory, Markdowns & Online Storefront Visibility
Search your booth items, update prices when running a markdown, put items on hold, or choose which pieces appear on the mall's public online storefront.
1
Open ๐ฆ My Inventory
Click ๐ฆ My Inventory in the top navigation bar. You can filter by Booth (if you rent more than one), Status (Available, On hold, Sold), or search by tag code, title, or category.
2
Edit an item's price, photos, or description
Click 'Edit' on any Available item to open it in the editor. Update the price, title, description, or photos and click Save. The register will immediately use your updated price the next time that tag is scanned.
๐ก Tip: If you change the price of an item, remember to update or reprint the physical tag on the item in your booth so shoppers see the matching price.
3
Toggle Online Storefront visibility
Have a fragile or oversized piece you only want sold in person? Uncheck 'Publish to mall online storefront' when editing the item. It stays scannable at the front desk but won't appear on the website.
4
Remove an item you took home
If you pull an unsold piece from your booth, open it via 'Edit' and click '๐๏ธ Delete item' (or set its status to 'Withdrawn') so your inventory count stays accurate.
โก Good to know- Items that have already been sold at the register are locked for accounting integrity and cannot be edited or deleted.
13. Track Your Live Daily Sales & Read Monthly Settlement Statements
Check what sold in your booth today from your phone, understand how commission and card fees are calculated on each line, and download your monthly payout statements.
1
Check real-time sales on '๐ My Booth' or '๐ My Sales'
As soon as the front-desk cashier rings up one of your items, it appears under 'Recent sales of your items' on your dashboard and in '๐ My Sales' โ showing the tag code, item title, gross price, mall commission, card fee (if paid by card), and your net earnings.
2
Export your sales to CSV for taxes or inventory tracking
In '๐ My Sales', pick any date range (such as the full calendar year) and click 'โฌ๏ธ Export CSV' to download your complete itemized sales history.
3
Review your Monthly Settlement Statements
Open '๐ธ Statements'. Each finalized monthly statement shows gross sales, commission, card fees, booth rent, adjustments and net payout. Contact your mall about the timing and status of payments made outside CuratorUSA.
4
Print or save a PDF copy of your statement
Use Print statement to print or save your finalized statement, or Export my statement CSV for its totals. Use My Sales to review individual recorded sales.
โก Good to know- Cash sales never carry a credit-card processing fee deduction โ even if your mall passes card fees through on credit/debit sales.