# Installer la Stripe CLI Installez la Stripe CLI sur macOS, Windows ou Linux. La Stripe CLI vous permet de créer, tester et gérer votre intégration depuis la ligne de commande. Vous pouvez utiliser la Stripe CLI pour : - Créez, récupérez, mettez à jour ou supprimez n’importe laquelle de vos ressources Stripe dans un environnement de test. - Diffusez en temps réel les requêtes API et les événements qui se produisent dans votre compte. - Déclenchez des événements pour tester votre intégration de webhooks. Pour plus de détails, consultez la [documentation de l’interface de ligne de commande (CLI) Stripe](https://docs.stripe.com/cli.md). [Watch on YouTube](https://www.youtube.com/watch?v=iFwBGI-kqeE) ## Installer l'interface de ligne de commande Stripe Depuis la ligne de commande, utilisez un script d’installation ou téléchargez et extrayez un fichier d’archive versionné pour votre système d’exploitation afin d’installer la CLI. #### homebrew Pour installer la CLI Stripe avec [homebrew](https://brew.sh/), exécutez la commande suivante : ```bash brew install stripe/stripe-cli/stripe ``` #### apt Le build Debian de la CLI est disponible sur [JFrog](https://packages.stripe.dev), qui n’est pas un domaine appartenant à Stripe. Lorsque vous visitez cette URL, elle vous redirige vers la liste de l’artifactory Jfrog. Pour installer la CLI Stripe sur des distributions Debian ou Ubuntu : 1. Ajoutez la clé GPG de l’interface de ligne de commande Stripe au trousseau de clés des sources apt : ```bash curl -s https://packages.stripe.dev/api/security/keypair/stripe-cli-gpg/public | gpg --dearmor | sudo tee /usr/share/keyrings/stripe.gpg > /dev/null ``` 1. Ajoutez le référentiel apt de la CLI à la liste des sources apt : ```bash echo "deb [signed-by=/usr/share/keyrings/stripe.gpg] https://packages.stripe.dev/stripe-cli-debian-local stable main" | sudo tee -a /etc/apt/sources.list.d/stripe.list ``` 1. Mettez à jour la liste des paquets : ```bash sudo apt update ``` 1. Installez la CLI : ```bash sudo apt install stripe ``` #### yum Le build RPM de la CLI est disponible sur [JFrog](https://packages.stripe.dev), qui n’est pas un domaine appartenant à Stripe. Lorsque vous visitez cette URL, elle vous redirige vers la liste de l’artifactory Jfrog. Pour installer la CLI Stripe sur des distributions RPM : 1. Ajoutez le référentiel yum de la CLI à la liste des sources yum : ```bash echo -e "[Stripe]\nname=stripe\nbaseurl=https://packages.stripe.dev/stripe-cli-rpm-local/\nenabled=1\ngpgcheck=0" >> /etc/yum.repos.d/stripe.repo ``` 1. Installez la CLI : ```bash sudo yum install stripe ``` #### Scoop Pour installer la CLI Stripe avec [Scoop](https://scoop.sh/), exécutez la commande suivante : ```bash scoop bucket add stripe https://github.com/stripe/scoop-stripe-cli.git ``` ```bash scoop install stripe ``` #### macOS Pour installer la CLI Stripe sous macOS sans homebrew : 1. Téléchargez le dernier fichier tar.gz `mac-os` correspond au type d’architecture de votre processeur depuis [GitHub](https://github.com/stripe/stripe-cli/releases/latest). 1. Décompressez le fichier : `tar -xvf stripe_[X.X.X]_mac-os_[ARCH_TYPE].tar.gz`. En option, vous pouvez installer le binaire dans un emplacement où vous pouvez l’exécuter globalement (par exemple, `/usr/local/bin`). #### Linux Pour installer la CLI Stripe sous Linux sans gestionnaire de paquets : 1. Téléchargez le dernier fichier tar.gz `linux` depuis [GitHub](https://github.com/stripe/stripe-cli/releases/latest). 1. Décompressez le fichier : `tar -xvf stripe_X.X.X_linux_x86_64.tar.gz`. 1. Déplacez `./stripe` sur votre chemin d’exécution. #### Windows Pour installer la CLI Stripe sous Windows sans Scoop : 1. Téléchargez le dernier fichier zip `windows` depuis [GitHub](https://github.com/stripe/stripe-cli/releases/latest). 1. Décompressez le fichier `stripe_X.X.X_windows_x86_64.zip`. 1. Ajoutez le chemin vers le fichier `stripe.exe` désarchivé à votre variable d’environnement `Path`. Pour savoir comment actualiser les variables d’environnement, consultez la [documentation de PowerShell Microsoft](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_environment_variables?view=powershell-7.3#saving-changes-to-environment-variables). Les scanners antivirus de Windows signalent parfois la Stripe CLI comme étant dangereuse. Il s’agit très probablement d’un faux positif. Pour plus d’informations, consultez le [problème n° 692](https://github.com/stripe/stripe-cli/issues/692) dans le référentiel GitHub. #### Docker La CLI Stripe est aussi disponible sous forme d’[image Docker](https://hub.docker.com/r/stripe/stripe-cli). Pour installer la version la plus récente, exécutez la commande suivante : ```bash docker run --rm -it stripe/stripe-cli:latest ``` ## Se connecter à l'interface de ligne de commande 1. Connectez-vous et authentifiez votre compte [utilisateur](https://docs.stripe.com/get-started/account/set-up.md) Stripe pour générer un ensemble de clés limitées. Pour en savoir plus, consultez la page [Clés et autorisations de la Stripe CLI](https://docs.stripe.com/stripe-cli/keys.md). ```bash stripe login ``` 1. Appuyez sur la touche **Entrer** de votre clavier pour accomplir le processus d’authentification dans votre navigateur. ```bash Your pairing code is: enjoy-enough-outwit-win This pairing code verifies your authentication with Stripe. Press Enter to open the browser or visit https://dashboard.stripe.com/stripecli/confirm_auth?t=THQdJfL3x12udFkNorJL8OF1iFlN8Az1 (^C to quit) ``` En option, si vous ne souhaitez pas utiliser de navigateur, utilisez l’option `--interactive` pour vous authentifier avec une clé secrète d’API ou une clé limitée existante. Ceci est utile pour s’authentifier à la CLI sans navigateur, par exemple dans un pipeline d’intégration et de déploiement continus (CI/CD). ```bash stripe login --interactive ``` Vous pouvez également utiliser l’option `--api-key` pour spécifier votre clé secrète d’API en ligne à chaque fois que vous envoyez une requête. ```bash stripe login --api-key <> ```