---
title: "Fehlercodes: CheckoutOS-Doku | Chargezen"
description: "Referenz der CheckoutOS-Fehlercodes und Lösungen. Aus dem Bereich „Fehlerbehebung“ der Doku zu Chargezen CheckoutOS."
url: "https://chargezen.com/de/docs/checkoutos/troubleshooting/error-codes"
lang: "de"
updated: "2025-01-16"
---

Canonical URL: https://chargezen.com/de/docs/checkoutos/troubleshooting/error-codes

# 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 finden

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

Gültige Kampagnenstruktur

```json
{
  "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

Zahlungsfehler

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

Header für Anfragelimits

```text
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1642345678
Retry-After: 60
```

### COS-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?

[

### Häufige Fragen

Antworten auf häufige Fragen

Mehr erfahren



](https://chargezen.com/de/docs/checkoutos/troubleshooting/faq)[

### Support kontaktieren

Erhalte persönliche Hilfe von unserem Team

Mehr erfahren



](https://chargezen.com/de/docs/checkoutos/troubleshooting/support)

War diese Seite hilfreich?

Brauchst du mehr Hilfe? [Support kontaktieren](https://chargezen.com/de/docs/checkoutos/troubleshooting/support)