# Installer l'interface de ligne de commande de Stripe

Pour installer l'interface de ligne de commande de Stripe sous macOS, Windows ou Linux.

Le CLI de Stripe vous permet de construire, tester et gérer votre intégration à partir de la ligne de commande. Vous pouvez utiliser le CLI Stripe pour ce qui suit :

- Créez, récupérez, mettez à jour ou supprimez n’importe laquelle de vos ressources Stripe dans un bac à sable.
- Transmettre des requêtes API et des événements en temps réel sur votre compte
- Déclencher des événements Stripe pour tester une intégration de webhook.

Pour plus de détails, consulter la [Référence 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 de Stripe

À partir de 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 l’interface de ligne de commande.

#### homebrew

Pour installer l’interface de ligne de commande Stripe avec [homebrew](https://brew.sh/), exécutez la commande suivante :

```bash
brew install stripe/stripe-cli/stripe
```

#### apt

La version Debian de l’interface de ligne de commande est disponible sur [JFrog](https://packages.stripe.dev), qui n’est pas un domaine qui appartient Stripe. Lorsque vous vous rendez à cette adresse URL, elle vous redirige vers la liste d’archivage des versions Jfrog.

Pour installer l’interface de ligne de commande Stripe sur des distributions dérivées de Debian ou Ubuntu :

1. Ajoutez la clé GPG de l’interface de ligne de commande Stripe au porte-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 l’interface de ligne de commande à 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. Installer l’interface de ligne de commande

   ```bash
   sudo apt install stripe
   ```

#### yum

Le build RPM pour le 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 d’archivage des versions de Jfrog.

Pour installer l’interface de ligne de commande Stripe sur des distributions dérivées de RPM :

1. Ajoutez le référentiel yum de l’interface de ligne de commande à 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. Installer l’interface de ligne de commande

   ```bash
   sudo yum install stripe
   ```

#### Scoop

Pour installer l’interface de ligne de commande 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 l’interface de ligne de commande Stripe sous macOS sans homebrew :

1. Téléchargez le dernier fichier `mac-os` tar.gz de votre type d’architecture cpu à partir de [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`.

Vous pouvez au besoin installer le fichier binaire dans un emplacement à partir duquel vous pourrez l’exécuter (par exemple, `/usr/local/bin`).

#### Linux

Pour installer l’interface de ligne de commande Stripe sur Linux sans gestionnaire de paquets :

1. Téléchargez la dernière version du fichier `linux` tar.gz à partir de [GitHub](https://github.com/stripe/stripe-cli/releases/latest).

1. Décompressez le fichier `tar -xvf stripe_X.X_linux_x86_64.tar.gz`.

1. Déplacez `./stripe` sur votre chemin d’exécution.

#### Windows

Pour installer l’interface de ligne de commande Stripe sous Windows sans Scoop :

1. Téléchargez la dernière version du fichier `windows` zip à partir de [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 d’accès au fichier `stripe.exe` décompressé à votre variable d’environnement `Path`. Pour savoir comment mettre à jour les variables d’environnement, consultez la [documentation de Microsoft PowerShell](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 analyses antivirus de Windows signalent parfois que l’interface de ligne de commande Stripe n’est pas sécurisée. Il s’agit très probablement d’un faux positif. Pour en savoir plus, consultez [le problème 692](https://github.com/stripe/stripe-cli/issues/692).

#### Docker

L’interface de ligne de commande 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 Stripe](https://docs.stripe.com/get-started/account/set-up.md) afin de générer un jeu de clés limitées. Pour en savoir plus, consultez la documentation relative aux [clés de l’interface de ligne de commande Stripe et aux autorisations](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)
   ```

Si vous ne souhaitez pas utiliser de navigateur, optez pour l’indicateur `--interactive` pour vous identifier à l’aide d’une clé secrète API ou d’une clé limitée existante. Cet indicateur est utile lorsque vous vous identifiez auprès de la CLI sans navigateur, par exemple dans un pipeline CI/CD.

```bash
stripe login --interactive
```

Vous pouvez également utiliser l’option `--api-key` pour spécifier votre clé secrète API en ligne à chaque fois que vous envoyez une requête.

```bash
stripe login --api-key <<YOUR_SECRET_KEY>>
```