# Instale o Stripe CLI

Instale o Stripe CLI no macOS, Windows ou Linux.

O Stripe CLI permite que você crie, teste e gerencie sua integração a partir da linha de comando. Você pode usar o Stripe CLI para:

- Crie, recupere, atualize ou exclua qualquer um dos seus recursos da Stripe em uma área restrita.
- Transmitir em tempo real solicitações e eventos de API ocorridos na sua conta
- Acione eventos para testar a integração de webhooks.

Para mais detalhes, veja a [Referência à CLI da Stripe](https://docs.stripe.com/cli.md).
[Watch on YouTube](https://www.youtube.com/watch?v=iFwBGI-kqeE)
## Instale a Stripe CLI

Na linha de comando, use um script de instalação ou baixe e extraia um arquivo com controle de versão para que o sistema operacional instale a CLI.

#### homebrew

Para instalar a Stripe CLI com [homebrew](https://brew.sh/), execute:

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

#### apt

A versão Debian para a CLI está disponível no [JFrog](https://packages.stripe.dev) que não é um domínio de propriedade da Stripe. Ao acessar esse URL, você será redirecionado para a lista de ferramentas do Jfrog.

Para instalar a Stripe CLI em distribuições baseadas em Debian e Ubuntu:

1. Adicione a chave GPG da Stripe CLI ao conjunto de chaves de fonte do 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. Adicione o repositório do apt da CLI à lista de fontes do 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. Atualize a lista de pacotes:

   ```bash
   sudo apt update
   ```

1. Instale a CLI:

   ```bash
   sudo apt install stripe
   ```

#### yum

A versão RPM para a CLI está disponível no [JFrog](https://packages.stripe.dev) em https://packages.stripe.dev, que não é um domínio de propriedade da Stripe. Ao acessar esse URL, você será redirecionado para a lista de ferramentas do Jfrog.

Para instalar a Stripe CLI em distribuições baseadas em RPM:

1. Adicione o repositório do yum da CLI à lista de fontes do 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. Instale a CLI:

   ```bash
   sudo yum install stripe
   ```

#### Scoop

Para instalar a Stripe CLI com o [Scoop](https://scoop.sh/), execute:

```bash
scoop bucket add stripe https://github.com/stripe/scoop-stripe-cli.git
```

```bash
scoop install stripe
```

#### macOS

Para instalar a Stripe CLI no macOS sem homebrew:

1. Baixe o arquivo `mac-os` tar.gz mais recente do seu tipo de arquitetura de cpu em [GitHub](https://github.com/stripe/stripe-cli/releases/latest).

1. Descompacte o arquivo: `tar -xvf stripe_[X.X.X]_mac-os_[ARCH_TYPE].tar.gz`.

Opcionalmente, você pode instalar o binário em um local onde possa executá-lo globalmente (por exemplo, `/usr/local/bin`).

#### Linux

Para instalar a Stripe CLI no Linux sem um gerenciador de pacotes:

1. Baixe o arquivo `linux` tar.gz mais recente em [GitHub](https://github.com/stripe/stripe-cli/releases/latest).

1. Descompacte o arquivo: `tar -xvf stripe_X.X.X_linux_x86_64.tar.gz`.

1. Mova `./stripe` para o caminho de execução.

#### Windows

Para instalar a Stripe CLI no Windows sem o Scoop:

1. Baixe o arquivo zip `windows` mais recente em [GitHub](https://github.com/stripe/stripe-cli/releases/latest).

1. Descompacte o arquivo `stripe_X.X.X_windows_x86_64.zip` file.

1. Adicione o caminho do arquivo `stripe.exe` descompactado à variável de ambiente`Path`. Para saber como atualizar variáveis de ambiente, consulte a [documentação do 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).

Os antivírus do Windows ocasionalmente sinalizam a Stripe CLI como insegura. Isso provavelmente é um falso positivo. Para mais informações, consulte o [Problema #692](https://github.com/stripe/stripe-cli/issues/692) no repositório do GitHub.

#### Docker

A Stripe CLI também está disponível como [imagem do Docker](https://hub.docker.com/r/stripe/stripe-cli). Para instalar a versão mais recente, execute:

```bash
docker run --rm -it stripe/stripe-cli:latest
```

## Entre na CLI

1. Faça login e autentique sua [conta](https://docs.stripe.com/get-started/account/set-up.md) de usuário da Stripe para gerar um conjunto de chaves restritas. Para saber mais, consulte [Stripe CLI: chaves e permissões](https://docs.stripe.com/stripe-cli/keys.md).

   ```bash
     stripe login
   ```

1. Pressione **Enter** no seu teclado para concluir o processo de autenticação no navegador.

   ```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)
   ```

Se não quiser usar um navegador, use o sinalizador `--interactive` para se autenticar com uma chave secreta ou restrita de API existente. Isso é útil para autenticação na CLI sem um navegador, como em um pipeline de CI/CD.

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

Você também pode usar o sinalizador `--api-key` para especificar sua chave secreta de API em linha sempre que enviar uma solicitação.

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