Déclencher des événements de webhook avec l'interface de ligne de commande Stripe
Découvrez comment déclencher des événements de webhook en mode test.
Il existe deux façons de déclencher des événements de webhook en mode test :
- Effectuez les actions qui conduisent à l’événement que vous souhaitez déclencher. Par exemple, la création d’un client avec l’API Stripe ou dans le Dashboard Stripe génère un événement
customer.
.created - Exécutez une commande avec l’interface de ligne de commande Stripe pour générer automatiquement l’événement.
Ce guide se concentre sur l’interface de ligne de commande Stripe.
Déclencher des événements![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Pour afficher le nom de tous les événements pris en charge par l’interface de ligne de commande Stripe, exécutez cette commande.
stripe trigger --help
Pour déclencher un événement spécifique, exécutez cette commande en remplaçant <EVENT>
par le nom de l’événement.
stripe trigger <EVENT>
Par exemple, cette commande déclenche l’événement payment_
.
stripe trigger payment_intent.succeeded
Ensuite, vous pouvez visualiser l’événement dans la page des événements du Dashboard Stripe ou en utilisant la commande stripe listen.
Note
En fonction de l’événement que vous déclenchez, l’interface de ligne de commande Stripe peut générer plusieurs événements connexes. Par exemple, lors de l’exécution de stripe trigger price.
, elle doit créer un produit pour créer un tarif, et génère donc deux événements : product.
et price.
.
Personnaliser les événements![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Pour générer des événements, l’interface de ligne de commande Stripe appelle l’API Stripe avec certains paramètres prédéfinis. Par exemple, pour déclencher l’événement payment_
, l’interface de ligne de commande Stripe appelle l’endpoint « create PaymentIntent » avec le paramètre amount
défini sur 2000
. Vous pouvez modifier ces paramètres d’API à l’aide de l’option override
.
stripe trigger <EVENT> --override <RESOURCE>:<PROPERTY>=<VALUE>
Voici quelques exemples de l’utilisation de remplacements.
# Set a top-level parameter stripe trigger customer.created --override customer:name=Bob # Set a nested parameter stripe trigger customer.created --override customer:"address[country]"=FR # Append an element to the end of a list stripe trigger customer.created --override customer:"preferred_locales[]"=FR # Replace an element of a list stripe trigger customer.created --override customer:"preferred_locales[0]"=FR # Set a parameter inside a list stripe trigger customer.subscription.created --override subscription:"items[0][price]"=price_xxx
Vous pouvez également combiner plusieurs remplacements sur différentes ressources.
stripe trigger price.created \ --override product:name=foo \ --override price:unit_amount=4200
Pour savoir quelles ressources et quels paramètres vous pouvez modifier, examinez les déclencheurs pertinents dans le répertoire GitHub de l’interface de ligne de commande Stripe.
Personnalisation d’événements avancée![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Si les événements ou remplacements disponibles ne sont pas suffisants pour votre cas d’usage, vous pouvez écrire un fichier JSON décrivant comment générer un événement et utiliser l’interface de ligne de commande pour déclencher cet événement. Consultez la documentation de l’API pour en savoir plus.