Développer un moteur de coupons et de codes promotionnels avec API pour le paiement

Mon magasin en ligne lance des promotions presque tous les mois, et en ce moment chaque code promo est un casse-tête : le développeur l'intègre en dur dans le code et le marketing attend. Je veux remplacer ce chaos par un moteur de coupons normal que l'équipe marketing peut gérer elle-même, sans programmeur. La tâche principale est de générer des codes de réduction (un à la fois et en grandes quantités), de les stocker dans la base de données et de les vérifier dans la même seconde lorsqu'un client entre le code au moment du paiement. Chaque code doit avoir son propre ensemble de règles : réduction en pourcentage, montant fixe, offre "achetez-en un, obtenez-en un" ou réduction uniquement sur la première commande. Nous avons également besoin de limites d'utilisation par code et par client, de dates de début et de fin, et d'un seuil de montant minimum du panier optionnel pour que le code soit valide.

Le cœur du projet est une petite API REST que la page de paiement appellera. Étant donné un code et le total actuel du panier, elle doit rapidement répondre : le code est-il valide, quelle réduction appliquer, et pourquoi il a été rejeté (expiré, limite atteinte, mauvais client, panier trop petit). Il est important que le système gère en toute sécurité les échanges concurrents afin qu'un code limité ne puisse pas être dépensé deux fois dans une condition de course, et chaque échange est enregistré pour le reporting. Un ajout agréable serait un simple panneau d'administration où un employé non technique peut créer un code, choisir une règle, définir des limites et des dates, et mettre en pause ou désactiver un code à la volée.

Je vous demande de vous concentrer spécifiquement sur les codes de réduction. Ce n'est pas un programme de parrainage ou une application de fidélité avec des points, donc je n'ai pas besoin d'invitations d'amis, de niveaux et d'accumulation de soldes de points. Le plus important : un calcul de réduction correct, une validation sécurisée sous charge, et une API que mon développeur frontend pourra facilement intégrer. La documentation et quelques exemples de requêtes seraient très utiles.

— Génération de codes : unique et en lot, avec des préfixes arbitraires et un format lisible
— Types de règles : pourcentage, montant fixe, BOGO, première commande uniquement
— Limites : utilisations totales, par client, montant minimum du panier, dates de validité
— API de validation : point de terminaison REST rapide retournant la validité, le montant de la réduction et la raison
— Rédemption concurrente sécurisée avec journal complet pour reporting
— Panneau d'administration simple pour la création, la pause et la désactivation des codes