Bon d'achat
Vue d'ensemble
Un bon d'achat est un instrument de remise à usage unique généré à partir du solde accumulé d'un Membre. Les bons sont le mécanisme d'échange dans Otonum. ils convertissent la valeur de récompense stockée (points ou cashback) en une remise appliquée à la caisse.
Cycle de vie
-
Solde accumulé. Le Membre gagne des points ou du cashback sur plusieurs achats.
-
Bon créé. Le Membre choisit d'échanger. Otonum crée un bon et déplace le montant correspondant du
balancevers letotalReserved. -
Bon validé à la caisse. Votre système appelle l'endpoint de validation pour confirmer que le bon est toujours actif et obtenir la remise définitive en espèces.
-
Achat soumis avec l'échange. Votre système soumet l'achat en incluant la référence du bon. Otonum marque le bon comme utilisé et met à jour le solde.
-
Expiration (si non utilisé). Si le bon n'est pas utilisé dans les 30 jours, il expire automatiquement et le montant réservé est retourné au
balance.
Montant résiduel
Si un bon est partiellement utilisé (le montant de l'achat est inférieur à la valeur du bon), le montant résiduel génère automatiquement un nouveau bon qui hérite de la date d'expiration du bon original.
Vous n'avez pas besoin de gérer les montants résiduels manuellement. Otonum crée automatiquement le nouveau bon. La réponse à l'endpoint d'achat inclura la nouvelle référence de bon le cas échéant.
Le flow valider / réserver / racheter
Le flux d'échange requiert trois étapes séquentielles pour prévenir les doubles dépenses dans des scénarios de requêtes concurrentes :
- Valider. Confirmer que le bon est actif et récupérer la
cashValuedéfinitive. - Réserver. Verrouiller le bon pour votre transaction. Un bon réservé ne peut pas être utilisé par une autre requête concurrente.
- Racheter. Soumettre l'achat avec la référence du bon. Otonum le marque comme consommé.
Ne jamais appeler racheter sans réservation confirmée. Sauter l'étape de réservation expose votre intégration aux conditions de course (TOCTOU) où deux caisses concurrentes pourraient tenter de consommer le même bon.
Quand créer un bon
Créez les bons à la demande à la caisse. uniquement lorsque le Membre choisit activement d'échanger. Évitez de créer des bons à l'avance (lors de l'inscription ou selon un calendrier), car cela bloque inutilement le solde du Membre pendant 30 jours et peut empêcher d'autres échanges.
Points importants
- Un bon est toujours limité à un tenant. il ne peut pas être échangé chez un partenaire différent.
- Le solde minimum requis pour créer un bon est défini dans vos paramètres de programme.
- Un bon consommé ou expiré ne peut pas être réactivé.
Voir aussi
- Paramètres de l'application. Seuils minimum de remboursement
- Enregistrer des activités. Comment soumettre un achat avec un bon
- Guide d'intégration. Flux de caisse complet incluant l'échange