Fehlercodes
Referenz der CheckoutOS-Fehlercodes und Lösungen
Zuletzt aktualisiert: 2025-01-16
Diese Referenz erklärt mögliche CheckoutOS-Fehlercodes mit Bedeutung und empfohlenen Lösungsschritten.
Fehlercodes erscheinen in Dashboard-Meldungen, Browserkonsole und Webhook-Antworten. Suche nach dem Format COS-XXXX.
Installationsfehler (COS-1XXX)
COS-1001: Shopify-Verbindung fehlgeschlagen
Ursache: Verbindung zum Shopify-Shop konnte nicht hergestellt werden.
Lösungen:
- Shop-URL auf Richtigkeit prüfen
- Prüfen, ob der Shop aktiv und nicht pausiert oder gesperrt ist
- CheckoutOS aus dem Shopify App Store neu installieren
- Admin- oder Inhaberberechtigungen sicherstellen
COS-1002: Zugriff verweigert
Ursache: CheckoutOS fehlen erforderliche Berechtigungen.
Lösungen:
- App zur erneuten Autorisierung neu installieren
- Anmeldung als Inhaber oder Admin prüfen
- Berechtigungen unter Shopify Admin → Apps → CheckoutOS prüfen
COS-1003: Checkout Extensibility nicht verfügbar
Ursache: Dein Plan unterstützt keine Checkout-Erweiterungen.
Lösungen:
- Für vollständige Erweiterbarkeit zu Shopify Plus wechseln
- Beta-Zugang zu Checkout Extensibility für Shops ohne Plus beantragen
- Nur Nachkauf-Funktionen verwenden, die in allen Plänen verfügbar sind
Kampagnenfehler (COS-2XXX)
COS-2001: Ungültige Kampagnenkonfiguration
Ursache: Einstellungen fehlen oder sind ungültig.
Lösungen:
- Alle erforderlichen Kampagnenfelder prüfen
- Mindestens ein Upsell-Produkt auswählen
- Gültige Rabattwerte sicherstellen
{
"name": "Summer Upsell",
"active": true,
"products": ["gid://shopify/Product/123"],
"discount": {
"type": "percentage",
"value": 20
},
"targeting": {
"minCartValue": 50
}
}COS-2002: Produkt nicht gefunden
Ursache: Ein Kampagnenprodukt existiert nicht mehr oder ist nicht verfügbar.
Lösungen:
- Prüfen, ob das Produkt aus Shopify gelöscht wurde
- Veröffentlichung und aktiven Status prüfen
- Kampagne mit gültigen Produkt-IDs aktualisieren
COS-2003: Konflikt bei Zielgruppenregeln
Ursache: Zielgruppenregeln widersprechen sich.
Lösungen:
- AND/OR-Logik prüfen
- Unzulässige Überschneidungen von Mindest- und Höchstwerten ausschließen
- Unmögliche Bedingungen suchen, etwa Warenkorb > US$100 UND Warenkorb < US$50
Checkout-Fehler (COS-3XXX)
COS-3001: Rabattanwendung fehlgeschlagen
Ursache: Rabatt konnte nicht auf das Upsell-Produkt angewendet werden.
Lösungen:
- Konflikte mit Shopify-Rabattcodes prüfen
- Rabattkombinationen in Shopify prüfen
- Sicherstellen, dass das Produkt nicht ausgeschlossen ist
COS-3002: Zahlungsfehler
Ursache: Upsell-Produkt konnte dem Kunden nicht berechnet werden.
Lösungen:
- Meist liegt ein Problem des Shopify-Zahlungs-Gateways vor
- Gateway-Status unter Shopify Admin → Settings → Payments prüfen
- Kunde muss eventuell eine andere Zahlungsmethode versuchen
CheckoutOS speichert niemals Zahlungsinformationen. Zahlungsfehler werden über Shopifys sichere Zahlungsinfrastruktur verarbeitet. Detaillierte Zahlungsprotokolle findest du in Shopify.
COS-3003: Bestand nicht verfügbar
Ursache: Das Upsell-Produkt ist ausverkauft.
Lösungen:
- Bestandsabhängige Alternativen in den Kampagneneinstellungen aktivieren
- Ersatzprodukte für ausverkaufte Artikel einrichten
- Falls passend, "Continue selling when out of stock" in Shopify einrichten
API-Fehler (COS-4XXX)
COS-4001: Ungültiger API-Schlüssel
Ursache: Ungültiger oder abgelaufener Schlüssel in der Anfrage.
Lösungen:
- Schlüssel unter Dashboard → Settings → API neu erzeugen
- Auf Tippfehler oder Leerzeichen prüfen
- Erforderliche Berechtigungen sicherstellen
COS-4002: Anfragelimit überschritten
Ursache: Zu viele API-Anfragen in kurzer Zeit.
Lösungen:
- Anfragen in deiner Anwendung drosseln
- Webhooks statt regelmäßiger Abfragen verwenden
- Für höhere Limits den Support kontaktieren
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1642345678
Retry-After: 60COS-4003: Ungültige Webhook-Signatur
Ursache: Signaturprüfung fehlgeschlagen.
Lösungen:
- Signaturschlüssel mit Dashboard → Settings → API abgleichen
- Unveränderten Anfrageinhalt zur Signaturprüfung verwenden
- Synchronisierte Serveruhr sicherstellen
Erweiterungsfehler (COS-5XXX)
COS-5001: Erweiterung konnte nicht laden
Ursache: Checkout-Erweiterung konnte im Browser nicht laden.
Lösungen:
- Browserkonsole auf JavaScript-Fehler prüfen
- Werbe- oder Datenschutzblocker vorübergehend deaktivieren
- Browsercache leeren und erneut versuchen
- Anderen Browser testen
COS-5002: Darstellungsfehler der Erweiterung
Ursache: Erweiterung wurde geladen, konnte aber nicht korrekt dargestellt werden.
Lösungen:
- Konflikte mit eigenem CSS prüfen
- Gültige und erreichbare Bild-URLs sicherstellen
- Erweiterung auf ungültige Einstellungen prüfen
Brauchst du weitere Hilfe?
Brauchst du mehr Hilfe? Support kontaktieren