FAQ
Häufige Fragen rund um CardPal — für Sammler, Käufer und Händler. Nutze das Inhaltsverzeichnis um direkt zu einem Thema zu springen.
📑 Inhalt
Allgemein
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.
Ja. Die Nutzung von CardPal ist für Nutzer kostenlos. Es gibt keine versteckten Kosten oder Abos für Sammler.
Nein. Viele Funktionen sind ohne Account nutzbar. Ein Account bringt dir jedoch Vorteile wie:
- personalisierte Features
- Discord-Verifizierung
- zukünftige Benachrichtigungen & Watchlists
Nutzer & Accounts
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
Nein. CardPal speichert nur die nötigsten Informationen (z. B. Discord-User-ID & Name) ➡️ keine privaten Chats, keine E-Mails, keine sensiblen Daten.
Ja, jederzeit. Du kannst deine Discord-Verbindung mit einem Klick trennen.
🛒 Deals, Shops & Produkte
Nein. CardPal ist kein Shop, sondern eine Plattform zur Darstellung von Angeboten. Alle Käufe erfolgen direkt beim jeweiligen Shop.
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.
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 ❤️
Wir aktualisieren die Daten regelmäßig, können aber keine Echtzeit-Garantie geben. Preise und Verfügbarkeit können sich im Shop kurzfristig ändern.
Haftung & Verantwortung
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
Mögliche Gründe:
- Produkt nicht mehr verfügbar
- Preis stark verändert
- Shop nicht mehr erreichbar
- Regelverstoß oder Anfrage des Shops
Zukunft & Features
Geplant (Auswahl):
- Deal-Benachrichtigungen
- persönliche Watchlists
- erweiterte Shop-Profile
- Community-Features
- App-Anbindung
Unbedingt! 👉 Über Discord oder direkt über CardPal. Community-Feedback ist Teil der Entwicklung.
Kontakt
- über den offiziellen Discord
- über das Kontaktformular auf CardPal
- per E-Mail
Händler — Listing-Anfrage
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.
🛍️ Shopify-Integration
Die MyCardPal-App ist eine kostenlose Shopify-App, die deine Produkte automatisch mit unserem TCG-Preisvergleich abgleicht. Installation in 4 Schritten:
- Im Shopify App Store nach „MyCardPal" suchen (in Kürze verfügbar — siehe Early-Access weiter unten)
- Auf „Add app" klicken → du wirst zur Berechtigungsfreigabe geleitet
- 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.
- 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.
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.
- Diese URL im Browser öffnen — dabei
DEIN-SHOP-SLUGdurch deinen eigenen Shop-Slug ersetzen (siehe unten, wie du ihn findest):https://admin.shopify.com/store/DEIN-SHOP-SLUG/apps/775206807edbe0a90ba2ae02c0d3c259 - Du wirst direkt in deinem Shopify-Admin landen und siehst eine „App hinzufügen"-Bestätigung
- Berechtigungen prüfen und auf „App installieren" klicken
- Die App öffnet sich embedded — der Initial-Sync läuft automatisch im Hintergrund
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 hiermein-tcg-shop. - Shopify-Einstellungen: Im Admin Settings → Domains öffnen. Unter „Default domain" steht z.B.
mein-tcg-shop.myshopify.com→ Slug istmein-tcg-shop. - Login-URL: Beim Login auf
accounts.shopify.comsiehst 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.
Nach erfolgreichem Klick auf „App installieren" passiert automatisch:
- Token-Austausch zwischen Shopify und MyCardPal (Sekunden)
- Shop-Metadaten (Name, Land, Währung, Kontakt-E-Mail) werden automatisch übernommen
- Initial-Sync deiner Produkte beginnt im Hintergrund — bei großen Shops kann das mehrere Minuten dauern (Shopify-Rate-Limit ≈ 450 Produkte/Min.)
- Die Embedded-UI zeigt einen Live-Progress-Banner während des Syncs
- 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.
Nur Produkt- und Bestandsdaten – keine Kund:innen-, Bestell- oder Zahlungsinformationen. Details in der Datenschutzerklärung der Shopify-Integration.
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.
Tags sind die schnellste und zuverlässigste Methode. Format schlüssel:wert:
set:Strixhavenoderset:Phyrexia: All Will Be One– setzt das Set-Hint für den Matcherlang:de,lang:en,lang:ja, … – ISO-639-1-Code (auchlang:Deutsch,lang:Japanese,lang:de-DEwerden 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
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").
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:Strixhavenoderlang: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.
- 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
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.
Während der Pilot-Phase kostenlos. Eventuelle künftige Preismodelle werden mindestens 30 Tage vor Inkrafttreten angekündigt. Details in den Nutzungsbedingungen.
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
🔧 Shopify-Integration – Troubleshooting
- Prüfe in der App-Übersicht den Match-Status — steht er auf „Offen" oder „Abgelehnt", warten wir auf manuelle Prüfung durch unser Team
- Steht der Status auf „Prüfung nötig" für deinen Shop selbst: bitte 3 Werktage warten (Initial-Review)
- 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
- Falls weiterhin nichts erscheint: [email protected] mit deiner Shop-Domain
- Setze einen
set:-Tag mit dem korrekten Set-Namen — das reduziert false positives drastisch - Setze
lang:debzw. die richtige Sprache, falls die Karte mehrsprachig im Katalog steht - Speichere das Produkt in Shopify erneut — wir re-matchen automatisch
- 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]
- Shopify-Webhooks haben gelegentlich Verzögerungen von ein paar Sekunden — kurz warten
- Falls länger als 5 Min Verzögerung: in Shopify das Produkt einmal speichern (löst
products/updateWebhook manuell aus) - Bei dauerhaften Problemen: möglicherweise hat Shopify Webhook-Subscriptions verloren — Deinstallation + Neuinstallation der App stellt sie wieder her
- Stelle sicher, dass das Produkt tatsächlich in der Collection ist (Shopify-Admin → Produkt → Tab „Organization" → Sektion „Collections")
- Speichere das Produkt einmal — der Collection-Lookup passiert beim
products/updateWebhook - Smart Collections (automatisch gefüllt durch Regeln) funktionieren genauso wie Manual Collections
- Wir holen max. 50 Collections pro Produkt — Produkte in mehr Collections können einzelne nicht-erkannt sein
- Browser-Cache leeren oder im Inkognito-Tab öffnen
- Browser-Extensions deaktivieren, die Iframes blockieren (uBlock, Privacy Badger im aggressiven Modus)
- Cookies für
admin.shopify.comundmycardpal.comerlauben - Falls weiterhin Probleme: Screenshot der Browser-DevTools-Console an [email protected]
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.
[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.
