Webhook d’affiliation

Un webhook d’affiliation est une notification HTTP envoyée à un autre système lorsqu’un événement lié à l’affiliation se produit, comme une conversion, une mise à jour de commission ou un changement de statut de paiement. Un callback ou un postback peut être utilisé pour des intégrations connexes. Les déclencheurs et les données utiles pris en charge dépendent de la plateforme.

Terminologie : webhook, callback et postback

Ces appellations se recoupent d’une plateforme à l’autre. Un webhook désigne une notification HTTP déclenchée par un événement. Callback est un terme plus général qui désigne une réponse ou une notification envoyée à un autre système. Dans les intégrations d’affiliation, postback désigne souvent un événement de conversion transmis par un serveur. Le sens de transmission, à lui seul, ne permet pas d’établir une distinction universelle.

Exemples d’événements et actions du système récepteur

Il s’agit d’exemples conceptuels, et non d’une garantie que chaque plateforme propose ces déclencheurs. Vérifiez le catalogue réel des événements et la version des données utiles avant de concevoir le système récepteur.

Webhooks et interrogation périodique

L’interrogation périodique consiste à demander à une API les changements selon un calendrier défini. Les webhooks transmettent les événements pris en charge au fur et à mesure qu’ils se produisent. Ils peuvent réduire les requêtes répétées à l’API, tandis que l’interrogation périodique ou le rapprochement peuvent aider à récupérer les états manquants. Une intégration robuste peut combiner les deux, au lieu de supposer que les notifications sont exhaustives et ordonnées.

Exemple de notification en double

Un événement d’approbation est envoyé deux fois après un délai d’attente dépassé. Le système récepteur reconnaît le même identifiant d’événement et n’enregistre qu’une seule transition d’état. Un remboursement ultérieur constitue un événement distinct qui doit tout de même être traité, même s’il concerne la même transaction.

C’est pourquoi dédupliquer tous les webhooks uniquement à partir de l’identifiant de transaction peut être une erreur. L’identifiant de l’événement et celui de la transaction remplissent des fonctions différentes.

Vérifications opérationnelles

Ne divulguez pas les identifiants d’accès dans des exemples publics, consignez les résultats de livraison sans données client superflues et déclenchez une alerte en cas d’échecs répétés. Le système récepteur doit accuser réception des requêtes conformément au protocole documenté par l’expéditeur et traiter les conséquences financières de manière sûre. Rapprochez les états importants avec ceux de la plateforme faisant autorité au lieu de vous fier uniquement à l’heure d’arrivée des notifications.

Concevoir un système récepteur adapté aux conditions réelles de livraison

Vérifiez quel événement déclenche la notification et s’il concerne une commission enregistrée, approuvée ou payée. Stockez l’identifiant de l’événement et celui de l’entité concernée, validez la requête au moyen du mécanisme d’authentification pris en charge par l’expéditeur et mettez en file d’attente les tâches qui ne peuvent pas être exécutées rapidement.

Prévoyez les événements en double, retardés, échoués ou reçus dans le désordre. Une nouvelle tentative doit mettre à jour le même enregistrement plutôt que de verser une prime deux fois. Si une approbation arrive avant l’enregistrement local de la vente, récupérez ou rapprochez l’état manquant au lieu de traiter l’ordre d’arrivée comme une règle métier.

La documentation officielle de Stripe sur les webhooks décrit des pratiques de livraison et de conception de points de terminaison ; ses signatures et ses données utiles sont spécifiques à Stripe. Pour connaître les champs réels, les déclencheurs pris en charge et les mécanismes d’authentification, consultez la documentation de la plateforme d’affiliation. Testez les réponses d’échec et le rapprochement avant de relier un webhook à une action financière.

Pour les paramètres correspondants dans Post Affiliate Pro, consultez la documentation sur les callbacks des webhooks . Vérifiez la configuration et les exigences d’intégration au regard des règles de votre programme.

Processus en un coup d’œil