34 — Ablefy-Integration (vormals elopage)

Ablefy ist die umbenannte Plattform „elopage" — ein deutscher Marketplace mit Affiliate-Programm. PartnerDesk akzeptiert sowohl neue als auch Legacy-Header-Namen.

Webhook-URL

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

Verarbeitete Events

Event	Aktion
payment / order.paid	Neue Transaktion + MLM-Provisionen
rebilling / subscription.charged	Folgezahlung
refund	TX auf refunded
chargeback	TX auf clawback

Setup

Ablefy-Account → Settings → Webhooks → URL eintragen + Signature-Schlüssel notieren → in PartnerDesk eintragen.

Signaturprüfung — Multi-Header-Support

Da Ablefy-Bestandskunden aus elopage-Zeiten oft noch die Legacy-Header senden, akzeptiert PartnerDesk drei mögliche Header:

1. X-Ablefy-Signature (aktueller Header).
2. X-Elopage-Signature (Legacy — Bestandskunden, die Webhook nicht umkonfiguriert haben).
3. X-Webhook-Signature (generischer Fallback aus White-Label-Setups).

Der erste valide Header gewinnt. HMAC-SHA256 über Raw-Body.

Verschachtelte Payload

Ablefy verschachtelt Daten oft in data.object.order. PartnerDesk hat einen internen Payload-Flattener, der das transparent auflöst — Sie als Tenant müssen sich darum nicht kümmern.

Affiliate-Identifikation

Drei Quellen, in Reihenfolge:

1. affiliate als verschachteltes Objekt mit external_id oder slug.
2. affiliate als String (Partner-Code).
3. affiliate_id als Integer (Ablefy-interne Partner-ID — wird gegen Partner.additionalExternalIds gemappt).

Tipp: Wenn Sie aus elopage importiert haben (siehe …/010-ablefy-webhook.md), tragen Sie die alte elopage-ID als externe ID an den Partnern ein — dann greift die Auflösung automatisch.

Customer-Daten

buyer.email, buyer.first_name, buyer.last_name, buyer.id.

CSV-Import

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

Identisches CSV-Format wie CopeCart.

Verwandte Kapitel

• 30 — Webhook-Übersicht
• 33 — CopeCart (gleiches CSV-Format)

---

Technische Tiefen-Doku: ../010-ablefy-webhook.md