Documentation

Everything you need to set up and run your store with TCG POS.

Getting Started

TCG POS is a complete point of sale and online storefront for trading card game shops. After signing up, follow these steps to get your store running:

1

Configure your store

Set your store name, contact info, logo, and banner in Manage → Settings.

2

Add locations and staff

Create your store locations and invite staff members with appropriate roles (owner, manager, or cashier).

3

Build your inventory

Add products from the built-in card catalog, set conditions and quantities, and configure pricing.

4

Set up the POS

Create registers, connect terminal hardware, and configure POS settings like tax rate and tipping.

5

Launch your storefront

Enable the online storefront, choose a theme, connect Stripe for payments, and configure shipping or pickup options.

Store Setup

Configure your store's identity and settings in Manage → Settings.

Basic Information

  • Store name and tagline — displayed on your storefront and receipts
  • Contact email and phone — shown to customers
  • Logo and banner — upload images for your storefront header
  • Social media links — Facebook, Instagram, and Twitter
  • Store hours — displayed on your storefront

Custom Domain

By default, your store is accessible at yourshop.tcgpos.io. On supported plans, you can map a custom domain (e.g., shop.yourstore.com) in Manage → Settings. The system handles DNS verification automatically.

Billing & Plans

View your current plan, feature limits, and available upgrades in Manage → Billing. Plans control access to features like custom domains, multi-location support, staff limits, and the video games catalog.

Locations & Staff

Locations

Each store can have one or more physical locations. Locations are used to scope inventory, registers, and pickup fulfillment. Create locations in Manage → Settings with a name, address, and phone number. Mark one location as your primary.

Staff Roles

Manage your team in Manage → Staff. Each staff member is assigned a role:

  • Owner — full access to all settings, billing, and staff management
  • Manager — access to inventory, products, orders, events, and POS settings
  • Cashier — POS register access only

Staff members are assigned to a location and can be activated or deactivated without deleting their account. The number of staff you can add depends on your plan.

Manager approval can be required for discounts above a configurable threshold. Set this in Manage → POS Settings.

Inventory Management

TCG POS integrates with the CardTrader catalog, giving you access to a comprehensive database of trading card products across multiple games. Manage your inventory in Manage → Inventory.

Adding Inventory

1

Browse the product catalog

Go to Manage → Products to search and browse the card catalog by game and expansion.

2

Add items to inventory

Select products and add them to your inventory at a specific location. Set the condition, quantity, and price for each variant.

3

Configure variants

Each inventory item can have variants based on condition (mint, near mint, lightly played, moderately played, heavily played, damaged) and modifiers (foil, first edition, signed, altered, reverse holo).

Inventory Details

Each inventory item tracks:

  • Quantity — updated automatically when sales are recorded
  • Price — can be set manually or derived from catalog pricing with pricing rules
  • Cost basis — what you paid, for margin tracking
  • Online availability — toggle whether the item appears on your storefront, with an optional separate online price
  • SKU and barcode — for scanning and label printing
  • Custom name and image — override the catalog defaults if needed

Inventory Transfers

Move inventory between locations in Manage → Transfers. Create a transfer request specifying the source location, destination, and items with quantities. Transfers follow a status workflow: pending, approved, completed, or cancelled.

Categories

Organize products into custom categories in Manage → Categories. Categories are used to filter products on the storefront, in the POS, and when applying pricing rules. Categories support a parent/child hierarchy.

Pricing Rules

Apply automatic markups or markdowns across your inventory in Manage → Pricing Rules. Instead of setting prices on every item individually, pricing rules let you adjust prices in bulk.

How Rules Work

  • Rules apply by game, expansion, or product category
  • Adjustments can be a percentage or fixed amount (positive for markup, negative for markdown)
  • Each rule has a priority — when multiple rules match a product, the highest priority rule wins
  • Rules can be enabled or disabled without deleting them
Individual price overrides on an inventory item always take precedence over pricing rules.

Point of Sale

The POS register is a full-screen interface for ringing up in-store sales. Access it at /pos after signing in as a staff member.

Ringing Up a Sale

1

Select your register

Choose which register you're using from the register picker. This determines which terminal device receives card payment requests.

2

Add items to the cart

Search for products by name, browse by category, scan a barcode, or use quick-add buttons for common items. Adjust quantities as needed.

3

Apply discounts (optional)

Apply a discount to the sale. Discounts above the configured threshold require manager approval.

4

Collect payment

Choose Cash or Card. Card payments are routed to the terminal device on your register. Tax is calculated automatically based on your configured rate.

POS Settings

Configure the register experience in Manage → POS Settings:

  • Tax rate — applied to all POS sales
  • Tipping — enable/disable with preset tip percentages (default: 15%, 18%, 20%)
  • Quick-add items — shortcuts for frequently sold items
  • Default payment method — pre-select cash or card
  • Barcode scan mode — search (find and confirm) or quick-add (straight to cart)
  • Discount approval threshold — require manager PIN for discounts above a set amount
  • Receipt header/footer — custom text printed on receipts

Buyback at the Register

The POS also supports buying cards back from customers. Search for a product, select the condition, and the system calculates a buyback offer based on your buylist rules. Payment can be cash or store credit.

Terminal Payments

TCG POS supports card-present terminal payments so your customers can tap, insert, or swipe at the register. Three terminal providers are supported:

  • Stripe Terminal — client-side JavaScript SDK connects directly to the reader
  • Square Terminal — server-side checkout creation with device polling
  • Clover — REST Pay Display API with device polling

The terminal provider is configured at the tenant level in Manage → Hardware — all registers in your shop use the same provider. Each register is then assigned its own device ID so payments route to the correct hardware.

Register Configuration

Registers represent individual checkout stations. Each is tied to a location and assigned a terminal device. Create registers in Manage → Hardware and assign the device identifier for your provider:

  • Stripe: Reader ID (tmr_...) and Terminal Location ID (tml_...)
  • Square: Device ID (R5WNWB5B...)
  • Clover: Device Serial (printed on device)

Payment Flow

When a cashier selects Card as the payment method, the POS sends a payment request to the terminal device on the active register. The customer completes the payment on the device, and the POS polls for the result. Payments have a 60-second timeout and can be cancelled by the cashier at any time.

Stripe Terminal Setup

Prerequisites

  • A Stripe account with Terminal enabled
  • A registered Stripe Terminal reader (BBPOS WisePOS E, Verifone P400, etc.)
  • The reader must be on the same network as the POS device, or registered to a Stripe Terminal Location for internet mode

Configuration Steps

1

Select Stripe Terminal as provider

In Manage → Hardware, choose Stripe Terminal from the provider cards and click Save Provider.

2

Find your Reader ID

In the Stripe Dashboard → Terminal → Readers, locate your reader. The Reader ID looks like tmr_XXXXXXXXXXXXXX.

3

Find your Terminal Location ID

In Stripe Dashboard → Terminal → Locations, find or create a location. The Location ID looks like tml_XXXXXXXXXXXXXX.

4

Assign IDs to your register

In Manage → Hardware, scroll to Registers. Edit the register and enter the Stripe Reader ID and Terminal Location ID.

Stripe Terminal uses your platform Stripe keys. No additional API keys need to be entered — just the Reader ID and Location ID per register.

Square Terminal Setup

Prerequisites

  • A Square account
  • A Square Developer application with Terminal API permissions
  • A registered Square Terminal device

Configuration Steps

1

Select Square Terminal as provider

In Manage → Hardware, choose Square Terminal and click Save Provider.

2

Create a Square Developer app

Go to the Square Developer Dashboard and create an application. Under Credentials, copy the Access Token (starts with EAAAl...).

3

Get your Location ID

In the Square Developer Dashboard, go to Locations. Copy the Location ID (looks like LXXXXXXXXXXXXXX).

4

Enter credentials in TCG POS

Back in Manage → Hardware, enter the Square Access Token and Square Location ID, then click Save Provider. Credentials are validated before saving.

5

Assign Device ID to your register

Edit your register and enter the Square Device ID (looks like R5WNWB5B...). Each register needs its own device ID.

Clover Setup

Prerequisites

  • A Clover merchant account
  • The Cloud Pay Display app installed on your Clover device
  • An API access token with payment permissions
Required: The Cloud Pay Display app must be installed on your Clover device before this integration will work. Install it from the Clover App Market.

Configuration Steps

1

Select Clover as provider

In Manage → Hardware, choose Clover and click Save Provider.

2

Get your Access Token

In the Clover Dashboard, go to Setup → API Tokens. Create or copy a token (looks like xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).

3

Get your Merchant ID

In the Clover Dashboard, go to Account & Setup. Your Merchant ID is shown at the top (looks like XXXXXXXXXXXXXXXX).

4

Enter credentials in TCG POS

Back in Manage → Hardware, enter the Clover Access Token and Clover Merchant ID, then click Save Provider. Credentials are validated before saving.

5

Assign Device Serial to register

Edit your register and enter the Clover Device Serial (printed on the back of your Clover device). Each register needs its own serial.

Online Storefront

TCG POS includes a public-facing online storefront where customers can browse your inventory, add items to a cart, and check out. Enable it in Manage → Storefront.

Enabling the Storefront

Toggle the storefront on in Manage → Storefront. Your store will be accessible at yourshop.tcgpos.io (or your custom domain). Only inventory items marked as available online will appear.

Theme Customization

Customize the look of your storefront with theme settings:

  • Theme presets — choose from pre-built color schemes
  • Colors — primary, accent, and background colors
  • Font family — select from available typefaces
  • Custom CSS — add your own styles for advanced customization

Payments

Online payments are processed through Stripe Connect. Connect your Stripe account in Manage → Storefront to start accepting online orders.

Fulfillment Options

Configure how customers receive their orders:

  • Shipping — enable shipping and configure shipping methods with rates and constraints. Shipping labels can be generated through EasyPost.
  • Pickup — let customers pick up orders at a store location. Assign which locations offer pickup.

Customer Accounts

Customers can create accounts on your storefront to save shipping addresses, view order history, manage a wishlist, and submit buylist offers. Accounts require email verification.

Orders & Fulfillment

Manage online orders in Manage → Orders. Orders flow through the following statuses:

PendingPaidProcessingShipped / Ready for PickupCompleted

Each order shows the customer email, items with quantities and prices, fulfillment type (shipping or pickup), and payment status. You can filter and search orders by status.

Inventory is automatically decremented when an order is placed. Cancelled or refunded orders restore inventory.

Events & Tournaments

Create and manage store events in Manage → Events. Events appear on your storefront's public events calendar.

Creating Events

Each event includes:

  • Title and description — what the event is about
  • Date and time — start and end times
  • Location — where the event takes place
  • Entry fee — optional cost to participate
  • Max participants — optional capacity limit
  • Color — for calendar display

Recurring Events

Events can be set to recur on a schedule: weekly, biweekly, or monthly. Recurring events are automatically expanded up to 90 days into the future (up to 13 occurrences), so customers always see upcoming dates.

Public Calendar

Customers can view upcoming events on your storefront at /events. The calendar shows events in both calendar and list views, with filtering by event type.

Buylist

The buylist lets customers sell cards to your shop. Configure buylist settings in Manage → Buylist.

Buylist Rules

Set buyback percentages that determine how much you offer for cards relative to their catalog value. Rules can be scoped to a specific game or expansion:

  • Buy percentage — what fraction of catalog value you offer (e.g., 50%)
  • Credit bonus — extra percentage added when the customer takes store credit instead of cash (e.g., 10% bonus)
  • Overrides — set specific buy prices for individual products, overriding the percentage-based calculation

Customer Submissions

Customers with accounts can browse your buylist on the storefront, select cards and quantities, and submit an offer. Submissions appear in Manage → Buylist → Submissions where you can approve or reject them.

Buyback at the POS

Walk-in customers can also sell cards at the register. The POS calculates offers using the same buylist rules and supports payment via cash or store credit.

Barcode Scanning

TCG POS supports barcode scanning for faster inventory lookups and POS checkout.

Scanning at the Register

The POS supports two barcode scan modes, configurable in Manage → POS Settings:

  • Search mode — scanning a barcode searches for the product so you can confirm before adding to cart
  • Quick-add mode — scanning a barcode immediately adds the product to the cart

Barcode Labels

Generate and print barcode labels for your inventory in Manage → Barcode Settings. Configure the label format, layout, and which information to include. You can assign custom SKU and barcode values to any inventory item.

Barcode scanning uses the device camera via the html5-qrcode library. External USB and Bluetooth barcode scanners also work as they emulate keyboard input.

Troubleshooting

General

“Not authenticated” error

Your session has expired. Sign out and sign back in, then select your register again.

Products not appearing on storefront

Make sure the storefront is enabled in Manage → Storefront and that the inventory items you want visible have online availability toggled on with a quantity greater than zero.

Pricing doesn't match expectations

Check your pricing rules in Manage → Pricing Rules. A higher-priority rule may be overriding a lower one. Individual price overrides on inventory items always take precedence over rules.

Terminal Payments

“No device configured for this register”

The active register doesn't have a device ID set. Go to Manage → Hardware, edit the register, and enter the appropriate device ID for your provider.

“Invalid credentials” when saving provider

Square and Clover credentials are validated when you save. Double-check your Access Token and Location/Merchant ID. Make sure you're using production credentials, not sandbox.

Payment times out after 60 seconds

The customer didn't interact with the terminal in time. Start a new payment. If this keeps happening, check that the correct device ID is assigned to the register and that the device is displaying the payment prompt.

Stripe reader not connecting

Ensure the reader is on the same network as the POS device (for local mode) or that the Terminal Location ID is correct (for internet mode). Try rebooting the reader.

Clover “Cloud Pay Display” errors

Make sure the Cloud Pay Display app is installed and open on the Clover device. The app must be running for the REST Pay Display API to route payments to the device.

Square payment shows as pending indefinitely

The checkout may have been created but the device didn't receive it. Verify the Device ID on the register matches your Square Terminal. Cancel the payment and try again.

Orders & Storefront

Customer can't complete checkout

Ensure Stripe Connect is set up in Manage → Storefront. Also check that at least one fulfillment option (shipping or pickup) is enabled.

Shipping rates not showing at checkout

Configure shipping methods in Manage → Storefront → Shipping. Each shipping method needs at least one option with a rate.