Mettre à jour dynamiquement les réductions
Apprenez à appliquer et à modifier les codes de réduction lors du paiement.
Version bêta privée
Les réductions dynamiques sont en version bêta privée. Demandez l’accès aux mises à jour dynamiques de la caisse.
Découvrez comment ajouter ou supprimer dynamiquement des réductions sur une session Checkout.
Cas d’usage
Ce guide vous explique comment intégrer votre système de réductions interne pour créer des remises dynamiques, mais vous pouvez également appliquer :
- Des remises de fidélité : appliquez automatiquement des remises en fonction du niveau de fidélité du client ou de l’historique d’achat.
- Des promotions sur la valeur du panier : Ajoutez des réductions lorsque le total de la commande dépasse des seuils spécifiques (par exemple, 10 $ de réduction sur les commandes de plus de 100 $).
- Des offres à durée limitée : appliquez des remises promotionnelles à durée limitée ou supprimez les codes de réduction expirés.
- Des remises basées sur la localisation : appliquez des remises spécifiques à chaque région en fonction de l’adresse de livraison du client.
- Des offres spécifiques aux clients : créez des montants de remise personnalisés en fonction de certains segments de clientèle ou comportements d’achat passés.
API Payment Intents
Si vous utilisez l’API Payment Intents, vous pouvez appliquer des remises en calculant et en modifiant manuellement le montant du paiement, ou en créant un nouveau PaymentIntent avec des montants réajustés.
Configurer le SDKCôté serveur
Utilisez nos bibliothèques officielles pour accéder à l’API Stripe depuis votre application :
Mettre à jour le SDK du serveurCôté serveur
Pour utiliser cette fonctionnalité de prévisualisation, mettez d’abord à jour votre SDK afin d’utiliser l’en-tête de version bêta : checkout_.
Configurer les autorisations de mise à jour pour la session CheckoutCôté serveur
Lorsque vous créez une session de paiement, transmettez l’option permissions.update_discounts=server_only pour désactiver l’application des réductions côté client et permettre la mise à jour des réductions à partir de votre serveur.
Mettre à jour dynamiquement les réductionsCôté serveur
Créez un endpoint sur votre serveur pour appliquer les réductions pendant la session Checkout. Vous l’appellerez à partir de l’interface dans une étape ultérieure.
Conseil en matière de sécurité
Le code côté client s’exécute dans un environnement contrôlé par l’utilisateur. Un utilisateur malveillant peut contourner votre validation côté client, intercepter et modifier des requêtes, ou créer de nouvelles requêtes vers votre serveur.
Lors de la création d’un endpoint, nous vous recommandons ce qui suit :
- Créez des endpoints pour des interactions spécifiques avec les clients au lieu de les rendre génériques. Par exemple, « appliquer une remise de fidélité » au lieu d’une action générale de « mise à jour ». Des endpoints spécifiques peuvent faciliter l’écriture et la maintenance de la logique de validation.
- Ne transmettez pas les données de session directement du client à votre endpoint. Des clients malveillants peuvent modifier les données de requête, ce qui en fait une source peu fiable pour déterminer l’état d’une session de paiement. Au lieu de cela, transmettez l’identifiant de session à votre serveur et utilisez-le pour récupérer en toute sécurité les données à partir de l’API Stripe.
Tester l’intégration
Suivez ces étapes pour tester votre intégration et vous assurer que vos remises dynamiques fonctionnent correctement.
Configurez un environnement de test qui reflète votre configuration en mode production. Utilisez les clés API d’environnement de test Stripe pour cet environnement.
Simulez différents scénarios de remise pour vérifier que votre fonction
recomputeDiscountsgère correctement les différents scénarios.Vérifiez la logique côté serveur en utilisant des outils de journalisation ou de débogage pour vous assurer que votre serveur :
- Récupère la session Checkout.
- Valide les demandes de réduction.
- Recalcule les réductions mises à jour en fonction de votre logique métier.
- Mets à jour la session Checkout avec les nouvelles réductions lorsque vos conditions personnalisées sont remplies. Assurez-vous que la réponse de mise à jour contient les nouvelles réductions. Par défaut, la réponse ne contient pas le champ discounts, sauf si la requête développe l’objet.
Vérifiez la logique côté client en effectuant plusieurs fois le processus de paiement dans votre navigateur. Observez la façon dont l’interface utilisateur se met à jour après l’application d’une réduction. Assurez-vous que :
- La fonction runServerUpdate est appelée comme prévu.
- Les remises s’appliquent correctement en fonction de votre logique métier.
- Le total du paiement est mis à jour pour refléter la réduction appliquée.
- Les messages d’erreur s’affichent correctement lorsqu’une application de réduction a échoué.
Testez divers scénarios de réduction, y compris des demandes de remise non valides, ou simulez des erreurs de serveur pour tester la gestion des erreurs, tant du côté serveur que du côté client.