Webhooks

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.

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

• 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

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

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

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é.

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