---
title: "Webhooks: Spark!-Doku | Chargezen"
description: "Erhalte Ereignisbenachrichtigungen in Echtzeit. Aus dem Bereich „API-Referenz“ der Doku zu Chargezen Spark!."
url: "https://chargezen.com/de/docs/spark/api/webhooks"
lang: "de"
updated: "2026-01-19"
---

Canonical URL: https://chargezen.com/de/docs/spark/api/webhooks

# Webhooks

Erhalte Ereignisbenachrichtigungen in Echtzeit

Zuletzt aktualisiert: 2026-01-19

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

## Webhooks einrichten

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

## Verfügbare Ereignisse

*   **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

## Nutzdatenformat

Webhook-Nutzdaten sind JSON-Objekte mit:

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

Idempotenz

Nutze das Feld `id`, um doppelte Ereignisse auszusortieren. In seltenen Fällen kann dasselbe Ereignis mehrfach zugestellt werden.

## Webhooks überprüfen

Ü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

## Wiederholungsregeln

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.

## Webhooks testen

Teste deinen Webhook-Endpunkt:

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

## Nächste Schritte

[

### REST-Endpunkte

Erkunde die REST-API

Mehr erfahren



](https://chargezen.com/de/docs/spark/api/endpoints)[

### Daten exportieren

Optionen für den Massendatenexport

Mehr erfahren



](https://chargezen.com/de/docs/spark/analytics/exporting)

### Verwandte Artikel

[

#### REST-Endpunkte

API-Endpunkte



](https://chargezen.com/de/docs/spark/api/endpoints)[

#### Authentifizierung

API-Authentifizierung



](https://chargezen.com/de/docs/spark/api/authentication)

War diese Seite hilfreich?

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