FAQ

Was ist CardPal?

CardPal ist eine Plattform für Trading-Card-Sammler (z. B. Pokémon, TCG), die Deals, Produkte und Shops übersichtlich bündelt. Unser Ziel: Transparenz, bessere Preise und eine starke Community.

Ist CardPal kostenlos?

Ja. Die Nutzung von CardPal ist für Nutzer kostenlos. Es gibt keine versteckten Kosten oder Abos für Sammler.

Muss ich ein Konto erstellen?

Nein. Viele Funktionen sind ohne Account nutzbar. Ein Account bringt dir jedoch Vorteile wie:

• personalisierte Features
• Discord-Verifizierung
• zukünftige Benachrichtigungen & Watchlists

Wie funktioniert die Discord-Verifizierung?

Du kannst deinen Discord-Account mit CardPal verbinden. Dadurch:

• wird dein Discord-Name auf CardPal angezeigt
• erhältst du auf Discord automatisch eine Verifizierungs-Rolle
• erkennst du verifizierte Nutzer & Community-Mitglieder

Werden meine Discord-Daten gespeichert?

Nein. CardPal speichert nur die nötigsten Informationen (z. B. Discord-User-ID & Name) ➡️ keine privaten Chats, keine E-Mails, keine sensiblen Daten.

Kann ich meine Verknüpfung wieder entfernen?

Ja, jederzeit. Du kannst deine Discord-Verbindung mit einem Klick trennen.

Verkauft CardPal selbst Produkte?

Nein. CardPal ist kein Shop, sondern eine Plattform zur Darstellung von Angeboten. Alle Käufe erfolgen direkt beim jeweiligen Shop.

Sind die Shops vertrauenswürdig?

Wir listen nur Shops, die öffentlich erreichbar sind und regelmäßig geprüft werden. Trotzdem gilt: Bitte prüfe vor jedem Kauf selbst AGB, Versand & Widerrufsrecht des Shops.

Sind Affiliate-Links im Einsatz?

Ja, teilweise. Einige Links können Affiliate-Links sein. ➡️ Für dich entsteht kein Nachteil oder Mehrpreis ➡️ Du unterstützt damit den Betrieb von CardPal ❤️

Sind die Preise immer aktuell?

Wir aktualisieren die Daten regelmäßig, können aber keine Echtzeit-Garantie geben. Preise und Verfügbarkeit können sich im Shop kurzfristig ändern.

Wer haftet bei Problemen mit einer Bestellung?

Der jeweilige Shop, bei dem du gekauft hast. CardPal ist nicht Vertragspartei und übernimmt keine Haftung für:

• Lieferverzögerungen
• beschädigte Ware
• Rücksendungen oder Reklamationen

Warum wird ein Deal entfernt oder geändert?

Mögliche Gründe:

• Produkt nicht mehr verfügbar
• Preis stark verändert
• Shop nicht mehr erreichbar
• Regelverstoß oder Anfrage des Shops

Welche Funktionen sind geplant?

Geplant (Auswahl):

• Deal-Benachrichtigungen
• persönliche Watchlists
• erweiterte Shop-Profile
• Community-Features
• App-Anbindung

Kann ich Feedback oder Feature-Wünsche einreichen?

Unbedingt! 👉 Über Discord oder direkt über CardPal. Community-Feedback ist Teil der Entwicklung.

Wie erreiche ich euch?

• über den offiziellen Discord
• über das Kontaktformular auf CardPal
• per E-Mail

Wie kann ich als Händler gelistet werden?

Bitte senden Sie eine E-Mail an [email protected] mit Website‑URL, API‑URL, Access‑Token und weiteren relevanten Informationen. Alternativ: nutze die Shopify-App (siehe nächste Sektion) für vollautomatische Anbindung.

Wie installiere ich die MyCardPal-App in meinem Shopify-Shop?

Die MyCardPal-App ist eine kostenlose Shopify-App, die deine Produkte automatisch mit unserem TCG-Preisvergleich abgleicht. Installation in 4 Schritten:

1. Im Shopify App Store nach „MyCardPal" suchen (in Kürze verfügbar — siehe Early-Access weiter unten)
2. Auf „Add app" klicken → du wirst zur Berechtigungsfreigabe geleitet
3. Berechtigungen bestätigen — als Vertriebskanal liest die App Produkte und Lagerbestand (read_products, read_inventory) sowie den Veröffentlichungsstatus (read_publications, read_product_listings) und richtet den MyCardPal-Vertriebskanal ein (write_publications, write_resource_feedbacks). Bestellungen, Kund:innendaten und deine Produkte selbst werden weder gelesen noch verändert. Optional kann später read_discounts per Klick freigeschaltet werden, um Rabattcodes mit anzuzeigen.
4. Fertig — die App lädt nun automatisch deine Produkte und gleicht sie ab. Du siehst den aktuellen Match-Status im Shopify-Admin unter „Apps → MyCardPal".

Nach der Installation prüft unser Team deinen Shop kurz (üblicherweise innerhalb von 3 Werktagen), bevor die Angebote auf mycardpal.com öffentlich angezeigt werden.

🚀 Early Access – Installation vor dem offiziellen App-Store-Release

Die App ist aktuell im Review-Prozess für den Shopify App Store. Vertrauenswürdige Händler können sie aber bereits jetzt manuell installieren — die Funktionalität ist identisch zur späteren App-Store-Version.

1. Diese URL im Browser öffnen — dabei DEIN-SHOP-SLUG durch deinen eigenen Shop-Slug ersetzen (siehe unten, wie du ihn findest):
   https://admin.shopify.com/store/DEIN-SHOP-SLUG/apps/775206807edbe0a90ba2ae02c0d3c259
2. Du wirst direkt in deinem Shopify-Admin landen und siehst eine „App hinzufügen"-Bestätigung
3. Berechtigungen prüfen und auf „App installieren" klicken
4. Die App öffnet sich embedded — der Initial-Sync läuft automatisch im Hintergrund

Woher kenne ich meinen Shop-Slug?

Dein Shop-Slug ist der Teil deiner myshopify.com-Adresse vor .myshopify.com. Vier Wege ihn zu finden:

• URL-Leiste im Admin: Wenn du im Shopify-Admin bist, schau in die Browser-Adressleiste. Sie sieht aus wie:
  admin.shopify.com/store/mein-tcg-shop/orders
  → dein Slug ist hier mein-tcg-shop.
• Shopify-Einstellungen: Im Admin Settings → Domains öffnen. Unter „Default domain" steht z.B. mein-tcg-shop.myshopify.com → Slug ist mein-tcg-shop.
• Login-URL: Beim Login auf accounts.shopify.com siehst du in der Shop-Auswahl alle deine Slugs.
• Beispiel komplette Install-URL für einen Shop mit Slug mein-tcg-shop:
  https://admin.shopify.com/store/mein-tcg-shop/apps/775206807edbe0a90ba2ae02c0d3c259

Hinweis: Dein Shop-Slug ist nicht zwingend identisch mit deiner Custom-Domain (z.B. tcgshop.de) — Shopify vergibt den Slug bei der Shop-Erstellung und er bleibt dauerhaft gleich, auch wenn du später eine eigene Domain einrichtest.

Was passiert direkt nach der Installation?

Nach erfolgreichem Klick auf „App installieren" passiert automatisch:

1. Token-Austausch zwischen Shopify und MyCardPal (Sekunden)
2. Shop-Metadaten (Name, Land, Währung, Kontakt-E-Mail) werden automatisch übernommen
3. Initial-Sync deiner Produkte beginnt im Hintergrund — bei großen Shops kann das mehrere Minuten dauern (Shopify-Rate-Limit ≈ 450 Produkte/Min.)
4. Die Embedded-UI zeigt einen Live-Progress-Banner während des Syncs
5. Webhook-Subscriptions für künftige Produkt-/Bestands-Änderungen werden registriert (laufen ab sofort automatisch)

Du kannst die Embedded-UI während des Initial-Syncs schließen und später wiederkommen — der Sync läuft serverseitig weiter.

Welche Daten werden übertragen?

Nur Produkt- und Bestandsdaten – keine Kund:innen-, Bestell- oder Zahlungsinformationen. Details in der Datenschutzerklärung der Shopify-Integration.

Wie verbessere ich die automatische Zuordnung meiner Produkte?

Die App versucht jedes Produkt mit unserem Katalog zu matchen (Fuzzy-Match auf Name + Set + Sprache). Du kannst die Zuordnung mit drei Mitteln deutlich verbessern: Tags, Variant-Options und Collections. Reihenfolge der Priorität: Tags > Options > Title-Heuristik > Collections.

Best Practice 1: Tags für Set, Sprache und Foil

Tags sind die schnellste und zuverlässigste Methode. Format schlüssel:wert:

• set:Strixhaven oder set:Phyrexia: All Will Be One – setzt das Set-Hint für den Matcher
• lang:de, lang:en, lang:ja, … – ISO-639-1-Code (auch lang:Deutsch, lang:Japanese, lang:de-DE werden erkannt und normalisiert)
• foil (ohne Wert) – markiert die Variant als Foil

Akzeptierte Präfixe für Set: set:, edition:, expansion:, serie:. Für Sprache: lang:, language:, spr:, sprache:.

Beispiel-Tag-Liste für eine Charizard EX aus Phyrexia: All Will Be One auf Deutsch:
set:Phyrexia: All Will Be One, lang:de, foil

Best Practice 2: Variant-Options für Zustand & Sprache

Wenn du Karten in mehreren Zuständen verkaufst, leg sie als Shopify-Variants an. Die App erkennt automatisch:

• Option-Name „Condition" oder „Zustand" mit Werten wie Near Mint, NM, Played, Mint
• Option-Name „Finish", „Treatment", „Veredelung" mit Werten Foil, Holo, Normal
• Option-Name „Language" oder „Sprache" mit Werten wie de, en, Deutsch, Japanese

Selbst ohne passenden Option-Namen erkennt die App bekannte Condition-Strings in jeder Variant-Option (z. B. eine Option „Variante" mit Wert „Near Mint").

Best Practice 3: Collections für Set- und Sprach-Gruppierung

Wenn du Produkte bereits in Shopify-Collections sortiert hast, nutzt die App diese als zusätzliche Signal-Quelle (zum Beispiel wenn du keine Tags pflegst). Wir erkennen:

• Collection-Titel mit Präfix wie set:Strixhaven oder lang:de
• Collection-Titel mit Sprach-Schlüsselwort: „Deutsche Karten", „Japanese Singles", „English Booster", „Französische Boosters" …
• Sonstige Collection-Titel werden als möglicher Set-Name verwendet, sofern noch keiner aus Tags/Options ermittelt wurde

Wichtig: Tags und Variant-Options haben immer Priorität über Collections. Collections sind ein Fallback für Shops, die ihre Struktur nicht per Tag pflegen wollen.

Best Practice 4: Produkt-Titel und Produkt-Typ

• Setze Produkt-Typ in Shopify (z. B. „Single Card", „Booster Box", „Bundle", „Elite Trainer Box") – wird direkt übernommen
• Im Titel auf einen sauberen Namen achten: „Charizard EX 199/198" matcht besser als „Top Karte super selten Charizard ⭐⭐⭐"
• Bei mehreren Variants keine Set-Namen oder Sprache in den Variant-Titel schreiben (das macht Shopify automatisch aus den Optionen)
• Barcode (EAN/UPC) an Sealed-Produkten (Bundles, Booster Boxes) pflegen – wir nutzen ihn zukünftig für sehr präzises Matching

Wie sehe ich, welche Produkte zugeordnet sind?

Im Shopify-Admin unter Apps → MyCardPal findest du eine Tabelle aller deiner Produkte mit dem aktuellen Status:

• Gematcht (grün/blau) – Auto-Match oder manuell vom MyCardPal-Team zugeordnet
• Offen (gelb) – kein automatischer Match gefunden, wird manuell geprüft
• Abgelehnt (rot) – passt zu keinem unserer Katalog-Einträge (z. B. Custom-Produkt)

Die Konfidenz-Anzeige zeigt, wie sicher der automatische Match ist: 90 %+ = sehr sicher, 75-89 % = wahrscheinlich korrekt, <75 % = bitte prüfen.

Was kostet die Shopify-Integration?

Während der Pilot-Phase kostenlos. Eventuelle künftige Preismodelle werden mindestens 30 Tage vor Inkrafttreten angekündigt. Details in den Nutzungsbedingungen.

Wie deinstalliere ich die App?

Im Shopify-Admin unter Einstellungen → Apps und Vertriebskanäle die MyCardPal-App anklicken und „App entfernen". Sofort danach:

• Access-Token wird gelöscht, dein Listing wird deaktiviert
• Nach 48 Stunden werden alle shop-identifizierenden Daten gemäß DSGVO anonymisiert

Meine Produkte erscheinen nicht im Preisvergleich

1. Prüfe in der App-Übersicht den Match-Status — steht er auf „Offen" oder „Abgelehnt", warten wir auf manuelle Prüfung durch unser Team
2. Steht der Status auf „Prüfung nötig" für deinen Shop selbst: bitte 3 Werktage warten (Initial-Review)
3. Sind Preise oder Bestände bei dir in Shopify aktuell? Wir übernehmen das, was im Webhook ankommt — leere/0 Werte werden als „nicht verfügbar" behandelt
4. Falls weiterhin nichts erscheint: [email protected] mit deiner Shop-Domain

Auto-Match ordnet meine Karte dem falschen Artikel zu

1. Setze einen set:-Tag mit dem korrekten Set-Namen — das reduziert false positives drastisch
2. Setze lang:de bzw. die richtige Sprache, falls die Karte mehrsprachig im Katalog steht
3. Speichere das Produkt in Shopify erneut — wir re-matchen automatisch
4. Falls das Auto-Match weiterhin falsch ist: unser Team korrigiert manuelle Matches im Admin-Portal. Schreibe uns mit deinem Shopify-Produkt-Link an [email protected]

Preise / Lagerbestände aktualisieren sich nicht

1. Shopify-Webhooks haben gelegentlich Verzögerungen von ein paar Sekunden — kurz warten
2. Falls länger als 5 Min Verzögerung: in Shopify das Produkt einmal speichern (löst products/update Webhook manuell aus)
3. Bei dauerhaften Problemen: möglicherweise hat Shopify Webhook-Subscriptions verloren — Deinstallation + Neuinstallation der App stellt sie wieder her

Collections werden nicht erkannt

1. Stelle sicher, dass das Produkt tatsächlich in der Collection ist (Shopify-Admin → Produkt → Tab „Organization" → Sektion „Collections")
2. Speichere das Produkt einmal — der Collection-Lookup passiert beim products/update Webhook
3. Smart Collections (automatisch gefüllt durch Regeln) funktionieren genauso wie Manual Collections
4. Wir holen max. 50 Collections pro Produkt — Produkte in mehr Collections können einzelne nicht-erkannt sein

Die App lädt nicht im Shopify-Admin (weißer Bildschirm / Iframe-Fehler)

1. Browser-Cache leeren oder im Inkognito-Tab öffnen
2. Browser-Extensions deaktivieren, die Iframes blockieren (uBlock, Privacy Badger im aggressiven Modus)
3. Cookies für admin.shopify.com und mycardpal.com erlauben
4. Falls weiterhin Probleme: Screenshot der Browser-DevTools-Console an [email protected]

Ich finde die App nicht im Shopify-Admin

Im Shopify-Admin unter Apps → Installed apps nachschauen. Falls die App dort nicht auftaucht, war die Installation evtl. nicht erfolgreich — neu installieren und auf die Berechtigungs-Bestätigungsseite achten.

Wer hilft bei weiteren Fragen?

[email protected] — wir antworten üblicherweise innerhalb von 1-2 Werktagen. Bitte Shop-Domain und ggf. Produkt-Handle oder Variant-ID mitschicken, damit wir konkret nachschauen können.