Les coupons de réduction peuvent être de type import (les codes sont chargés
manuellement) ou de type API (les codes sont générés sur demande).
Pour générer des coupons de réduction à partir du site Web via l’API, votre site Web doit
exposer une URL de webhook qui :
- reçoit plusieurs paramètres GET,
- génère des codes uniques (à usage unique) sur votre site Web en fonction des
paramètres envoyés.
Les paramètres GET obligatoires qui peuvent être spécifiés sont les suivants :
- type – INT – Le type de le remise générée par le coupon, peut être 0 (valeur fixe), 1 (pourcentage) ou 2 (livraison gratuite)
- valeur – INT | FLOAT – Apparaît pour le type de pourcentage ou de la valeur fixe. Si discount_type est pourcentage (1), il contient le pourcentage de la remise, autrement il contient la valeur fixe.
Optionnellement, les paramètres suivants peuvent également être spécifiés :
- batch_size – INT – le nombre de codes qui devraient être générés par l’URL du webhook (C’est optionnel, mais on le recommande. Les codes peuvent être générés par lots pour réduire le nombre de requêtes. Un seul code peut être renvoyé même si ce paramètre est présent).
- prefix – String – le préfixe qui devrait être ajouté au début des codes.
- expire_date – String (Chaîne) – la date au format AAAA-MM-JJ HH:II:SS à laquelle les codes doivent expirer.
- min_amount – FLOAT – la valeur minimale du montant dans le panier pour lequel le coupon peut être appliqué (s’il est envoyé, il devrait être lié au montant sans TVA).
- la devise – STRING – peut être dans quelque soit la devise ou en EUR (elle est présente dans le cas dont on envoie la valeur fixe pour la réduction ou la valeur minimale de la commande).
La réponse renvoyée peut être un string (contenant le code généré, si un seul code a été
généré) ou un tableau ou “array” (liste de codes), au format json, qui contient les clés
suivantes :
- statut – 0 (pour erreur) ou 1 (pour succès),
- codes – array (tableau) contenant les codes générés (en cas de succès),
- msg – message d’erreur (en cas d’erreur).