# Instalar la CLI de Stripe Instalar la CLI de Stripe en macOS, Windows o Linux. La CLI de Stripe te permite diseñar, probar y gestionar tu integración desde la línea de comandos. Puedes usar la CLI de Stripe para: - Crear, recuperar, actualizar y eliminar los recursos de Stripe en el entorno de prueba. - Transmitir eventos y solicitudes de la API en tiempo real que tienen lugar en tu cuenta. - Activar eventos para probar tu integración de webhooks. Para obtener más información, consulta la [referencia de CLI de Stripe](https://docs.stripe.com/cli.md). [Watch on YouTube](https://www.youtube.com/watch?v=iFwBGI-kqeE) ## Instalar la CLI de Stripe Desde la línea de comandos, usa un script de instalación, o descarga y extrae una versión de un archivo de almacenamiento para tu sistema operativo e instala la CLI. #### homebrew Para instalar la CLI de Stripe con [homebrew](https://brew.sh/), ejecuta lo siguiente: ```bash brew install stripe/stripe-cli/stripe ``` #### apt La Debian diseñada para la CLI está disponible en [JFrog](https://packages.stripe.dev), que no es un dominio propiedad de Stripe. Al visitar esta URL, eres redirigido al repositorio de artefactos de Jfrog. Para instalar la CLI de Stripe en distribuciones basadas en Ubuntu y en Debian, realiza lo siguiente: 1. Añade la clave GPG de la CLI de Stripe para el llavero de fuentes 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. Añade el repositorio apt de la CLI a la lista de fuentes 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. Actualiza la lista de paquetes: ```bash sudo apt update ``` 1. Instala la CLI: ```bash sudo apt install stripe ``` #### yum La RPM diseñada para la CLI está disponible en [JFrog](https://packages.stripe.dev), que no es un dominio propiedad de Stripe. Al visitar esta URL, eres redirigido al repositorio de artefactos de Jfrog. Para instalar la CLI de Stripe en distribuciones basadas en RPM, realiza lo siguiente: 1. Agrega el repositorio yum de la CLI a la lista de fuentes 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. Instala la CLI: ```bash sudo yum install stripe ``` #### Scoop Para instalar la CLI de Stripe con [Scoop](https://scoop.sh/), ejecuta lo siguiente: ```bash scoop bucket add stripe https://github.com/stripe/scoop-stripe-cli.git ``` ```bash scoop install stripe ``` #### macOS Para instalar la CLI de Stripe en macOS sin homebrew, realiza lo siguiente: 1. Descarga el archivo tar.gz `mac-os` más reciente de tu tipo de arquitectura cpu desde [GitHub](https://github.com/stripe/stripe-cli/releases/latest). 1. Descomprime el archivo: `tar -xvf stripe_[X.X.X]_mac-os_[ARCH_TYPE].tar.gz`. Opcionalmente, instalar el binario en una ubicación donde puedas ejecutarlo globalmente (por ejemplo, `/usr/local/bin`). #### Linux Para instalar la CLI de Stripe en Linux sin un administrador de paquetes, realiza lo siguiente: 1. Descarga el archivo tar.gz `linux` más reciente desde [GitHub](https://github.com/stripe/stripe-cli/releases/latest). 1. Descomprime el archivo: `tar -xvf stripe_X.X.X_linux_x86_64.tar.gz`. 1. Mueve `./stripe` a tu ruta de ejecución. #### Windows Para instalar la CLI de Stripe en Windows sin Scoop: 1. Descarga el archivo ZIP `windows` más reciente desde [GitHub](https://github.com/stripe/stripe-cli/releases/latest). 1. Descomprime el archivo `stripe_X.X.X_windows_x86_64.zip`. 1. Añade la ruta al archivo descomprimido `stripe.exe` a la variable de entorno `Path`. Para obtener más información sobre cómo actualizar las variables de entorno, consulta la [documentación 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). En ocasiones, los antivirus de Windows marcan la CLI de Stripe como insegura. Es muy probable que se trate de un falso positivo. Para obtener más información, consulta el [Problema #692](https://github.com/stripe/stripe-cli/issues/692) en el repositorio de GitHub. #### Docker La CLI de Stripe también está disponible como [imagen de Docker](https://hub.docker.com/r/stripe/stripe-cli). Para instalar la última versión, ejecuta lo siguiente: ```bash docker run --rm -it stripe/stripe-cli:latest ``` ## Iniciar sesión en la CLI 1. Inicia sesión y autentica tu [cuenta](https://docs.stripe.com/get-started/account/set-up.md) de usuario de Stripe para generar un conjunto de claves restringido. Para obtener más información, consulta [Claves y permisos de la CLI de Stripe](https://docs.stripe.com/stripe-cli/keys.md). ```bash stripe login ``` 1. Presiona **Enter**\* en el teclado para completar el proceso de autenticación en el 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) ``` Opcionalmente, si no quieres usar un navegador, usa el indicador `--interactive` para autenticarte con una clave secreta de la API o con una clave restringida. Esto es útil al autenticarte en la CLI sin un navegador, como en un canal de datos de CI/CD ```bash stripe login --interactive ``` También puedes usar el comando `--api-key` para especificar tu clave secreta de la API alineada cada vez que envíes un solicitud. ```bash stripe login --api-key <> ```