Événements
Fidélité
Les mouvements de points d'un programme partagé avec le commerce.
Capacités loyalty.read et loyalty.write, qui reposent sur customers.read. Fait exigé au bonjour :
pointValueCents.
Kult Lab active la partie Fidélité avec la première application qui la déclare. Écrivez au support
avant de la déclarer : ce qui suit est le contrat, sa mise en service se fait avec vous.
loyalty.recorded
Un mouvement du solde utilisable, qui ne change plus une fois écrit.
{
"transactionId": "lt-55120",
"customerId": "c-2231",
"points": 48,
"kind": "earned",
"reason": "Commande 10412",
"at": "2026-10-30T14:05:00+01:00"
}
pointsest signé : positif pour un gain, négatif pour une dépense.atest l'instant où les points sont devenus utilisables. Un gain en attente n'est pas encore un mouvement : envoyez-le quand il devient utilisable.
kind | Sens |
|---|---|
earned | gagnés par un achat |
spent | dépensés contre une récompense |
earn_reversed, spend_reversed | un gain ou une dépense annulés |
adjusted | une correction à la main |
Le type compte : un gain ou une dépense compte comme une visite du client.
Un point vaut la même chose des deux côtés
Les points sont ceux du programme du commerce, un pour un. facts.pointValueCents doit égaler la valeur
d'un point de ce programme : une vérification le contrôle, et deux programmes qui ne s'entendent pas
sur ce que vaut un point ne se connectent pas.