Skip to main content
Chaque envoi est une requête POST JSON avec la même enveloppe :
id est stable : le même événement garde le même identifiant, même s’il est relancé. C’est votre clé de dédoublonnage. Le contenu de data dépend de l’événement ; les objets sale, license et product ont exactement la même forme que dans l’API.

Vue d’ensemble

Abonnez-vous à * pour recevoir tous les événements, y compris ceux que nous ajouterons plus tard. Ignorez simplement ceux que votre code ne connaît pas : c’est la manière la plus sûre de ne rien manquer.

Ventes

sale.completed

Le paiement est confirmé : c’est le signal pour livrer, facturer, notifier votre équipe. C’est le seul signal fiable d’un paiement réussi (ne vous fiez pas à la page de retour du client).

sale.failed

Sert à relancer le client ou à comprendre un problème de moyen de paiement. data.failure.reason donne la cause quand elle est connue (300 caractères maximum).

sale.abandoned

Un client a commencé une commande sans payer. Détecté par une tâche périodique, au bout d’une heure ; un seul événement par commande. Idéal pour une relance WhatsApp ou e-mail.

sale.refunded

Un paiement est remboursé (depuis le tableau de bord).

order.created

Une commande existe mais n’est pas encore payée. Utile pour réserver du stock ou suivre l’entonnoir. Pour savoir qu’elle est payée, attendez sale.completed.

Licences

Tous les événements de licence contiennent license, product et customer.email, plus sale.id quand la licence vient d’une commande.

license.issued

Une clé est attribuée à un client après son achat.

license.activated

Une clé est activée sur un appareil. license.activations liste les appareils actuels.

license.expiring

Une licence expire dans 7 jours ou moins. data.days_until_expiry donne le nombre de jours restants : parfait pour déclencher un rappel de renouvellement. Un seul événement par date d’expiration : si vous prolongez la licence, un nouvel événement pourra partir pour la nouvelle date.

license.expired

Une licence vendue vient d’expirer (dans les 48 dernières heures). Les clés jamais vendues ou déjà révoquées n’envoient rien.

license.revoked

Une licence est révoquée, par vous ou à la suite d’un remboursement. data.reason donne la raison quand elle est connue.

Affiliation

affiliate.joined

Un affilié génère son premier lien pour l’un de vos produits. Un seul événement par affilié.

Catalogue

product.published

Un produit passe en ligne. data.product a la forme complète d’un produit de l’API. Republier un produit plus tard envoie un nouvel événement.

Envoyer un événement de test

Dans le tableau de bord (Tester) ou par POST /pulses/{id}/test, Pulse-Sell envoie immédiatement un événement pulse.test clairement marqué : il utilise la même signature et la même enveloppe, avec des données fictives. Il n’influence pas le compteur d’échecs.