---
title: "Webhooks : documentation Spark! | Chargezen"
description: "Recevoir des notifications d’événements en temps réel. Extrait de la section Référence API de la documentation Spark! de Chargezen."
url: "https://chargezen.com/fr/docs/spark/api/webhooks"
lang: "fr"
updated: "2026-01-19"
---

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

# Webhooks

Recevoir des notifications d’événements en temps réel

Dernière mise à jour : 2026-01-19

Les webhooks avertissent votre application lorsqu’un événement survient dans Spark!. Recevez en temps réel les nouvelles commandes, inscriptions d’affiliés, versements et autres mises à jour.

## Configurer les webhooks

1.  Accédez à Settings → API → Webhooks
2.  Cliquez sur "Add Webhook Endpoint"
3.  Saisissez l’URL de l’endpoint, HTTPS requis
4.  Sélectionnez les événements à suivre
5.  Copiez le secret de signature pour la vérification

## Événements disponibles

*   **affiliate.created** — Inscription d’un nouvel affilié
*   **affiliate.approved** — Affilié approuvé
*   **affiliate.updated** — Profil affilié modifié
*   **order.attributed** — Commande rattachée à un affilié
*   **commission.created** — Commission calculée
*   **commission.approved** — Commission confirmée
*   **commission.paid** — Commission versée
*   **payout.created** — Lot de versements créé
*   **payout.completed** — Lot de versements traité
*   **click.recorded** — Clic sur un lien d’affiliation

## Format du contenu

Les contenus des webhooks sont des objets JSON comprenant :

*   `id` — Identifiant unique de l’événement
*   `type` — Type d’événement, par exemple "order.attributed"
*   `created_at` — Horodatage ISO 8601
*   `data` — Objet de données propre à l’événement

Idempotence

Utilisez le champ `id` pour dédupliquer les événements. Dans de rares cas, le même événement peut être livré plusieurs fois.

## Vérifier les webhooks

Vérifiez les signatures pour garantir l’authenticité :

1.  Extrayez l’en-tête `X-Spark-Signature`
2.  Calculez le HMAC-SHA256 du corps brut avec votre secret de signature
3.  Comparez la signature calculée à la valeur de l’en-tête
4.  Rejetez les requêtes qui ne correspondent pas

## Politique de nouvelles tentatives

Si votre endpoint échoue, avec une réponse autre que 2xx, Spark! réessaie :

*   Immédiatement
*   Après 5 minutes
*   Après 30 minutes
*   Après 2 heures
*   Après 24 heures

Après 5 tentatives échouées, le webhook est marqué comme échoué.

## Tester les webhooks

Testez votre endpoint :

*   Utilisez le bouton "Send Test Event" des paramètres
*   Consultez les journaux de livraison des webhooks
*   Relancez manuellement les livraisons échouées

## Prochaines étapes

[

### Points d’accès REST

Explorer l’API REST

En savoir plus



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

### Exporter les données

Options d’exportation en masse

En savoir plus



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

### Articles liés

[

#### Points d’accès REST

Endpoints API



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

#### Authentification

Authentification API



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

Cette page vous a-t-elle été utile ?

Besoin d’aide ? [Contacter l’assistance](https://chargezen.com/fr/docs/checkoutos/troubleshooting/support)