๐Ÿ›๏ธ CuratorUSA How-To Guide
๐Ÿ“ Mall Directoryโš–๏ธ Compare POSSign InStart Free Trial
๐Ÿ“– Interactive Step-by-Step User Manual

CuratorUSA How-To Guide for Mall Owners & Booth Vendors

Search step-by-step instructions for every feature โ€” from setting up booths, commission tiers, and Square POS webhooks to snapping AI Vision booth photos and printing QR/barcode hangtags.

Popular:
๐Ÿค Owners & VendorsGetting Startedโฑ 3 min
Staff access

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. 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. 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. 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. 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.
๐Ÿ›๏ธ Mall Owners & StaffGetting Startedโฑ 3 min
Open Mall Settings โ†’

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. 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. 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. 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. 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.
๐Ÿ›๏ธ Mall Owners & StaffSettlements & Reportsโฑ 4 min
Configure Settlement Policy โ†’

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. 1

    Open the Settlement Policy panel

    Navigate to โš™๏ธ Settings and locate the '๐Ÿ“ Settlement Policy' card on the right column.

  2. 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. 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. 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. 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.
๐Ÿ›๏ธ Mall Owners & StaffBooths & Vendorsโฑ 5 min
Open Booths & Vendors โ†’

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. 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. 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. 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. 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.
๐Ÿ›๏ธ Mall Owners & StaffRegister & Square POSโฑ 4 min
Open Square Settings โ†’

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. 1

    Open the Square POS & OAuth panel

    Go to โš™๏ธ Settings โ†’ '๐ŸŸฆ Square POS & OAuth' on the left column.

  2. 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. 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. 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. 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.
๐Ÿ›๏ธ Mall Owners & StaffRegister & Square POSโฑ 4 min
Open Front-Desk Register โ†’

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. 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. 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. 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. 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. 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. 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. 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.
๐Ÿ›๏ธ Mall Owners & StaffSettlements & Reportsโฑ 5 min
Open Settlements โ†’

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. 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. 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. 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. 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. 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.
๐Ÿ›๏ธ Mall Owners & StaffStorefront & Settingsโฑ 3 min
Open Reports & Ledger โ†’

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. 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. 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. 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.
๐Ÿค Owners & VendorsAI Intake & Inventoryโฑ 2 min
Open AI Intake โ†’

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. 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. 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. 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. 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. 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.
๐Ÿค Owners & VendorsTags & Barcodesโฑ 3 min
Open Tag Studio โ†’

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. 1

    Open the QR & Barcode Tag Studio

    Click ๐Ÿท๏ธ Tags (or '๐Ÿท๏ธ Print Tags' in the Vendor Portal).

  2. 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. 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. 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. 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%'.
๐Ÿงบ Booth Vendors / TenantsGetting Startedโฑ 2 min
Open Vendor Sign-Up โ†’

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. 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. 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. 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.
๐Ÿงบ Booth Vendors / TenantsAI Intake & Inventoryโฑ 3 min
Open My Inventory โ†’

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. 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. 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. 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. 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.
๐Ÿงบ Booth Vendors / TenantsSettlements & Reportsโฑ 3 min
Open My Statements โ†’

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. 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. 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. 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. 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.
How-To Guide for Antique Mall Owners & Booth Vendors | CuratorUSA