33 — CopeCart-Integration

CopeCart ist ein deutscher Marketplace mit Affiliate-Funktion. PartnerDesk empfängt CopeCart-Webhooks und CSV-Exporte.

Webhook-URL

https://<tenant-slug>.partnerdesk.io/api/webhooks/<tenant-slug>/copecart

Verarbeitete Events

CopeCart-Event	Aktion
payment	Neue Transaktion + MLM-Provisionen
rebilling	Folgezahlung — recurringNumber aus Payload
refund	TX auf refunded
chargeback	TX auf clawback

Setup

1. CopeCart-Webhook konfigurieren

CopeCart-Vendor-Account → Settings → Webhooks → Ihre PartnerDesk-URL eintragen.

2. Signature-Schlüssel

CopeCart zeigt einen Signature-Key, der für die HMAC-Validierung genutzt wird.

3. Eintragen in PartnerDesk

Admin → „Zahlungsanbieter" → CopeCart → Secret einsetzen.

Signaturprüfung — zwei Modi

CopeCart sendet je nach Konfiguration zwei Formate:

Format	Validierung
JSON (Content-Type: application/json)	HMAC-SHA256 über Raw-Body, verglichen mit X-CopeCart-Signature-Header
Form-Data (application/x-www-form-urlencoded)	Form-Felder alphabetisch sortiert + konkateniert, dann HMAC-SHA256

PartnerDesk wechselt automatisch zwischen beiden Modi.

Affiliate-Identifikation

CopeCart liefert:

• affiliate_id — alphanumerischer Partner-Code (priorisiert).
• sub_id — UTM-ähnlicher Kontext (Fallback).

Beide werden gegen Partner.partnerId des Tenants geprüft.

Customer-Daten

• buyer_email, buyer_first_name, buyer_last_name, buyer_id → werden zum Customer gemappt.

Brutto/Netto/Steuer

CopeCart liefert separat:

• total_amount (Brutto).
• total_amount_net (Netto).
• tax_amount und tax_rate.

Damit ist keine Rechnung nötig — Werte werden 1:1 in die Transaction übernommen.

CSV-Import historischer Daten

app:import:provider <tenant> copecart <transaktionen.csv>

Das CSV-Format ist identisch zu Ablefy (siehe 34) — beide Provider nutzen historisch denselben Aufbau.

Verwandte Kapitel

• 30 — Webhook-Übersicht
• 34 — Ablefy (verwandter Provider)

---

Technische Tiefen-Doku: ../008-copecart-webhook.md, ../084-copecart-import-and-filters.md