Récupérer un bon de réduction Stripe à partir de son code

Lorsque vous travaillez avec Stripe, il est fréquent d’utiliser des bons de réductions pour proposer des remises à vos clients.

Techniquement, Stripe identifie chaque code promo par un identifiant unique (par exemple promo_1Hd0sBG03p6y1vChab7Jh6Zs).

Récupérer un bon de réduction avec son identifiant

Avec l’API, c’est très simple de récupérer les informations d’un bon de réduction avec son identifiant unique, comme ici en utilisant le SDK (NodeJS) :

const promo = await stripe.promotionCodes.retrieve(
  'promo_1Hd0sBG03p6y1vChab7Jh6Zs'
);

Mais en pratique, vos clients ne connaissent pas cet identifiant technique.

Ce qu’ils saisissent dans votre formulaire de paiement, c’est un code promo lisible comme BLACKFRIDAY, alors comment faire ?

Récupérer un bon de réduction avec son code

Le problème, c’est que Stripe ne propose pas de méthode retrieve basée sur le code client, mais heureusement il y a quand même une solution simple.

Stripe met à disposition l’API List Promotion Codes, qui permet de filtrer directement par le champ code. Et comme chaque code promo doit être unique, la requête renverra un seul élément :

const promotionCodes = await stripe.promotionCodes.list({
  code: 'FIFTYOFF'
});

const promo = promotionCodes.data[0];

Vous récupérez donc directement le bon de réduction correspondant au code saisi par le client !

Attention néanmoins à bien vérifier que l’objet promo existe, en cas de code erroné !

Documentation officielle

Si vous voulez retrouver ces méthodes directement dans la documentation de Stripe, c'est ici : https://docs.stripe.com/api/promotion_codes