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
Import Or Scan
StartCards enter through CSV or marketplace import, a photo scan, or manual creation.
- 2
AI Identification
ProcessThe recognition pipeline matches each card to a catalog identity with a confidence score.
- 3
Exception Review
DecisionThe seller reviews flagged matches and fixes missing data — approve, edit, or dismiss — before anything becomes a listing.
- 4
Draft Listing
ProcessApproved items become DRAFT listings with catalog links, images, and pricing; the seller reviews and submits.
- 5
Admin Review
DecisionSubmitted listings sit PENDING while an admin verifies card details and images, then approves or rejects.
- 6
Live
ProcessApproval moves images to permanent storage, generates SEO, and activates the listing; it syndicates to connected sales channels.
- 7
Sold
DoneA buyer checks out; quantity decrements everywhere and the order enters fulfillment.
AI Recognition Pipeline
What happens between uploading card photos and confirming the identified card.
- 1
Upload
StartFront and back photos are compressed, validated (JPEG/PNG/WebP, 500×500 minimum), and archived as originals before any processing.
- 2
Cache & Cert Lookup
ProcessCheap matches run first: an exact image-hash cache hit answers without any AI spend, and graded cert numbers verify against grading company databases.
- 3
Confident Match?
DecisionA validated cache or cert hit at the 0.85 confidence bar answers immediately — the vision model only runs when the cheap paths miss.
- Yes — Cached Or Verified
- 4
Confirm Match
ProcessThe cached or cert-verified identity is confirmed with no vision model call.
- No — Run Vision
- 5
Vision Model
ProcessOne 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.
- 6
Candidate Ranking
ProcessCatalog candidates are matched in tiers — strict identity, fuzzy create-gate, same-set siblings, then DINOv3 image rescue — and ranked with a confidence score.
- 7
High Confidence?
DecisionThe model's raw confidence decides the route: 0.95 and above can auto-approve; below 0.7 always needs a human.
- Yes
- 8
Confirm Match
ProcessHigh-confidence matches are confirmed; at 0.95 and above manual review is skipped entirely.
- No
- 9
Review Queue
ProcessLow-confidence results land in the review queue flagged for the seller instead of auto-confirming.
- 10
Manual Confirm
ProcessThe seller confirms or corrects the suggested match before anything publishes.
- 11
Post To Listing
DoneConfirmed cards continue into the listing lifecycle as draft or review listings headed for approval.
Order & Fulfillment
The path an order takes from checkout to seller payout.
- 1
Checkout
StartThe buyer completes the three-step checkout (shipping, review, payment); PayPal captures payment and the order is created for the seller.
- 2
Funds Held
ProcessProceeds sit in the seller's pending balance, and a postage reserve from the buyer's shipping payment is set aside for the label.
- 3
Seller Ships
ProcessThe seller buys a USPS label (Shippo or ShipStation optional), packs the cards, and the order is marked shipped with tracking.
- 4
Tracking
ProcessCarrier scans update the shared order timeline; a confirmed delivery automatically promotes the order to delivered.
- 5
Delivery Issue?
DecisionDelivery confirmation opens the buyer-protection window for the order.
- No Issues
- Dispute Opened
- 6
Buyer Protection Review
ProcessSupport reviews the case; the disputed amount stays held and pending payouts pause until the dispute resolves.
- 7
Payout
DoneAfter the window clears, proceeds minus fees and any outstanding debt are paid out to the seller via PayPal.
Integration Sync
How a connected platform stays aligned with your SuperCatch inventory.
- 1
Connect Platform
StartOAuth or stored credentials connect the channel from the seller dashboard, and the product cache pre-warms.
- 2
Map Fields & Select
ProcessIn the import wizard the seller picks products and maps platform fields to SuperCatch fields before anything imports.
- 3
Initial Import
ProcessA background job pulls the platform catalog; images are processed, AI-matched, and unmatched data is flagged for review.
- 4
Delta Sync
ProcessScheduled runs pull only records changed since the last successful sync, with quick retries on failure.
- 5
Webhook Events
ExternalReal-time order and product events flow between SuperCatch and the platform where the platform supports them.
Related Guides
Explore the adjacent workflows that usually sit next to this topic.