Skip to main content
Documentation

Process Flows

The four end-to-end flows behind SuperCatch — how listings go live, how cards get identified, how orders ship, and how channels stay in sync.

Page Guide

Jump directly to the sections that matter for this page.

Documented Flows
4
Total Steps
30
Node Types
5

Listing Lifecycle

How a card travels from an import or scan to a live, sold listing.

  1. 1
    Import Or Scan
    Start

    Cards enter through CSV or marketplace import, a photo scan, or manual creation.

  2. 2
    AI Identification
    Process

    The recognition pipeline matches each card to a catalog identity with a confidence score.

  3. 3
    Exception Review
    Decision

    The seller reviews flagged matches and fixes missing data — approve, edit, or dismiss — before anything becomes a listing.

  4. 4
    Draft Listing
    Process

    Approved items become DRAFT listings with catalog links, images, and pricing; the seller reviews and submits.

  5. 5
    Admin Review
    Decision

    Submitted listings sit PENDING while an admin verifies card details and images, then approves or rejects.

  6. 6
    Live
    Process

    Approval moves images to permanent storage, generates SEO, and activates the listing; it syndicates to connected sales channels.

  7. 7
    Sold
    Done

    A buyer checks out; quantity decrements everywhere and the order enters fulfillment.

Related GuidesSelling GuideAI RecognitionIntegrations

AI Recognition Pipeline

What happens between uploading card photos and confirming the identified card.

  1. 1
    Upload
    Start

    Front and back photos are compressed, validated (JPEG/PNG/WebP, 500×500 minimum), and archived as originals before any processing.

  2. 2
    Cache & Cert Lookup
    Process

    Cheap matches run first: an exact image-hash cache hit answers without any AI spend, and graded cert numbers verify against grading company databases.

  3. 3
    Confident Match?
    Decision

    A validated cache or cert hit at the 0.85 confidence bar answers immediately — the vision model only runs when the cheap paths miss.

    1. Yes — Cached Or Verified
    2. 4
      Confirm Match
      Process

      The cached or cert-verified identity is confirmed with no vision model call.

    1. No — Run Vision
    2. 5
      Vision Model
      Process

      One scan credit is reserved, then the vision model (Webanto local LLM primary, GPT-4o-mini fallback) reads player, year, brand, set, and card number off the images.

    3. 6
      Candidate Ranking
      Process

      Catalog candidates are matched in tiers — strict identity, fuzzy create-gate, same-set siblings, then DINOv3 image rescue — and ranked with a confidence score.

    4. 7
      High Confidence?
      Decision

      The model's raw confidence decides the route: 0.95 and above can auto-approve; below 0.7 always needs a human.

      1. Yes
      2. 8
        Confirm Match
        Process

        High-confidence matches are confirmed; at 0.95 and above manual review is skipped entirely.

      1. No
      2. 9
        Review Queue
        Process

        Low-confidence results land in the review queue flagged for the seller instead of auto-confirming.

      3. 10
        Manual Confirm
        Process

        The seller confirms or corrects the suggested match before anything publishes.

  4. 11
    Post To Listing
    Done

    Confirmed cards continue into the listing lifecycle as draft or review listings headed for approval.

Related GuidesAI RecognitionSelling Guide

Order & Fulfillment

The path an order takes from checkout to seller payout.

  1. 1
    Checkout
    Start

    The buyer completes the three-step checkout (shipping, review, payment); PayPal captures payment and the order is created for the seller.

  2. 2
    Funds Held
    Process

    Proceeds sit in the seller's pending balance, and a postage reserve from the buyer's shipping payment is set aside for the label.

  3. 3
    Seller Ships
    Process

    The seller buys a USPS label (Shippo or ShipStation optional), packs the cards, and the order is marked shipped with tracking.

  4. 4
    Tracking
    Process

    Carrier scans update the shared order timeline; a confirmed delivery automatically promotes the order to delivered.

  5. 5
    Delivery Issue?
    Decision

    Delivery confirmation opens the window to report an order problem.

    1. No Issues
    1. Dispute Opened
    2. 6
      Order Problem Review
      Process

      Support reviews the case; the disputed amount stays held and pending payouts pause until the dispute resolves.

  6. 7
    Payout
    Done

    After the window clears, proceeds minus fees and any outstanding debt are paid out to the seller via PayPal.

Related GuidesBuying GuideShipping GuideSelling Guide

Integration Sync

How a connected platform stays aligned with your SuperCatch inventory.

  1. 1
    Connect Platform
    Start

    OAuth or stored credentials connect the channel from the seller dashboard, and the product cache pre-warms.

  2. 2
    Map Fields & Select
    Process

    In the import wizard the seller picks products and maps platform fields to SuperCatch fields before anything imports.

  3. 3
    Initial Import
    Process

    A background job pulls the platform catalog; images are processed, AI-matched, and unmatched data is flagged for review.

  4. 4
    Delta Sync
    Process

    Scheduled runs pull only records changed since the last successful sync, with quick retries on failure.

  5. 5
    Webhook Events
    External

    Real-time order and product events flow between SuperCatch and the platform where the platform supports them.

Related GuidesIntegrationsAPI Reference
Related Guides

Explore the adjacent workflows that usually sit next to this topic.

Selling GuideAI RecognitionAPI Reference
Keep Reading
Previous
API Reference
Next
FAQ
Was This Page Helpful?