Webhooks

Webhooks benachrichtigen deine Anwendung bei Ereignissen in Spark!. Erhalte Echtzeit-Updates zu neuen Bestellungen, Affiliate-Anmeldungen, Auszahlungen und mehr.

1. Navigiere zu Settings → API → Webhooks
2. Klicke auf "Add Webhook Endpoint"
3. Gib deine Endpunkt-URL ein (HTTPS erforderlich)
4. Wähle die Ereignisse aus, die du abonnieren möchtest
5. Kopiere das Signaturgeheimnis zur Überprüfung

• affiliate.created – neuer Affiliate registriert
• affiliate.approved – Affiliate wurde freigegeben
• affiliate.updated – Affiliate-Profil geändert
• order.attributed – Bestellung einem Affiliate zugeordnet
• commission.created – Provision berechnet
• commission.approved – Provision bestätigt
• commission.paid – Provision ausgezahlt
• payout.created – Auszahlungslauf erstellt
• payout.completed – Auszahlungslauf verarbeitet
• click.recorded – Affiliate-Link angeklickt

Webhook-Nutzdaten sind JSON-Objekte mit:

• id – eindeutige Ereignis-ID
• type – Ereignistyp (z. B. "order.attributed")
• created_at – ISO-8601-Zeitstempel
• data – ereignisspezifisches Datenobjekt

Überprüfe Webhook-Signaturen, um ihre Echtheit sicherzustellen:

1. Lies den Header X-Spark-Signature aus
2. Berechne HMAC-SHA256 des unverarbeiteten Bodys mit deinem Signaturgeheimnis
3. Vergleiche die berechnete Signatur mit dem Headerwert
4. Lehne Anfragen ab, die nicht übereinstimmen

Wenn dein Endpunkt fehlschlägt (keine 2xx-Antwort), versucht Spark! es erneut:

• Sofortiger neuer Versuch
• Nach 5 Minuten
• Nach 30 Minuten
• Nach 2 Stunden
• Nach 24 Stunden

Nach 5 fehlgeschlagenen Versuchen wird der Webhook als fehlgeschlagen markiert.

Teste deinen Webhook-Endpunkt:

• Nutze die Schaltfläche "Send Test Event" in den Einstellungen
• Sieh die Webhook-Zustellungsprotokolle ein
• Wiederhole fehlgeschlagene Zustellungen manuell