# Configura tu entorno de desarrollo

Familiarízate con la CLI de Stripe y nuestros SDK del lado del servidor.

Consulta nuestra [documentación que no requiere programación](https://docs.stripe.com/no-code.md), usa una [solución prediseñada](https://stripe.com/partners/directory) de nuestro directorio de socios o contrata a un [experto certificado por Stripe](https://stripe.com/partners/directory?t=Consulting).

Los SDK del lado del servidor y la interfaz de línea de comandos (CLI) de Stripe te permiten interactuar con las API REST de Stripe. Empieza a usar la CLI de Stripe para optimizar tu entorno de desarrollo y hacer llamadas de API.

Usa SDK para evitar escribir código estándar. Para empezar a enviar solicitudes desde tu entorno, elige un idioma y sigue una guía de inicio rápido.

> #### Extensiones de Chrome
> 
> Te recomendamos que crees tu integración de pagos con Stripe (como [Elements](https://docs.stripe.com/payments/elements.md) o [Checkout](https://docs.stripe.com/payments/checkout.md)) en tu propio sitio web. Luego, configura tu extensión de Chrome para enviar a los usuarios a esta página de pago cuando tengan todo listo para completar una compra.
> 
> Este método es más seguro y fácil de mantener que tratar de gestionar los pagos directamente dentro de la extensión.

# Ruby

> This is a Ruby for when lang is ruby. View the full page at https://docs.stripe.com/get-started/development-environment?lang=ruby.

En este QuickStart, instala [la CLI de Stripe](https://docs.stripe.com/stripe-cli.md), una herramienta esencial que te proporciona acceso a la línea de comandos para tu integración de Stripe. También instalarás el [servidor Ruby SDK de Stripe](https://github.com/stripe/stripe-ruby) para obtener acceso a las API de Stripe desde solicitudes escritas en Ruby.

## Lo que aprendes

En este inicio rápido, aprenderás a:

- Cómo llamar a las API de Stripe sin escribir una línea de código
- Cómo gestionar dependencias de terceros mediante el uso de un bundler con RubyGems
- Cómo instalar el SDK de Ruby de Stripe v18.4.0
- Cómo enviar tu primera solicitud de SDK

## Configuración inicial

Primero, [crea una cuenta de Stripe](https://dashboard.stripe.com/register) o [inicia sesión](https://dashboard.stripe.com/login).

## Configurar la CLI de Stripe

Primero, [crea una cuenta de Stripe](https://dashboard.stripe.com/register) o [inicia sesión](https://dashboard.stripe.com/login).

### Instalar

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. Luego, instala la CLI.

#### homebrew

Para instalar la CLI de Stripe con [homebrew](https://brew.sh/), ejecuta el siguiente comando:

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

Este comando falla si lo ejecutas en la versión de Linux de homebrew, pero puedes usar esta alternativa o seguir las instrucciones de la pestaña Linux.

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

#### apt

> La compilación Debian para la CLI está disponible en JFrog en https://packages.stripe.dev, que no es un dominio de la propiedad de Stripe. Cuando visites esta URL, te redirigirá a la lista de artefactos de Jfrog.

Para instalar la CLI de Stripe en distribuciones basadas en Ubuntu y en Debian:

1. Add Stripe CLI’s GPG key to the apt sources keyring:

```bash
curl -s https://packages.stripe.dev/api/security/keypair/stripe-cli-gpg/public | gpg --dearmor | sudo tee /usr/share/keyrings/stripe.gpg
```

1. Agrega 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 compilación RPM para la CLI está disponible en JFrog en https://packages.stripe.dev, que no es un dominio de la propiedad de Stripe. Cuando visites esta URL, te redirigirá a la lista de artefactos de Jfrog.

Para instalar la CLI de Stripe en distribuciones basadas en RPM:

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 el siguiente comando:

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

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

Otra opción es 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:

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. Agrega la ruta que lleva al archivo `stripe.exe` descomprimido 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).

> De vez en cuando, los detectores antivirus de Windows marcan la CLI de Stripe como no segura. Es probable que se trate de un falso positivo. Para obtener más información, consulta [problema n.º 692](https://github.com/stripe/stripe-cli/issues/692) en el repositorio de GitHub.

1. Ejecuta el archivo `.exe` descomprimido.

#### 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 el siguiente comando:

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

### Autenticar

Inicie sesión y autentique tu [cuenta](https://docs.stripe.com/get-started/account/activate.md) de usuario de Stripe para generar un conjunto de claves restringidas. Para obtener más información, consulte [Claves y permisos de la CLI de Stripe](https://docs.stripe.com/stripe-cli/keys.md).

```bash
  stripe login
```

Presiona la tecla **Enter** en tu teclado para completar el proceso de autenticación en tu 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)
```

### Confirmar configuración

Ahora que has instalado la CLI, puedes realizar una sola solicitud de API para [Crear un producto](https://docs.stripe.com/api/products/create.md).

#### bash

```bash
stripe products create \
--name="My First Product" \
--description="Created with the Stripe CLI"
```

Busca el identificador del producto (en `id`) en el objeto de respuesta. Guárdalo para el próximo paso.

Si todo funcionó, la línea de comandos muestra la siguiente respuesta.

#### bash

```json
{
  "id": "prod_LTenIrmp8Q67sa", // El identificador se ve de esta manera.
  "object": "product",
  "active": true,
  "attributes": [],
  "created": 1668198126,
  "default_price": null,
  "description": "Created with the Stripe CLI",
  "identifiers": {},
  "images": [],
  "livemode": false,
  "metadata": {},
  "name": "My First Product",
  "package_dimensions": null,
  "price": null,
  "product_class": null,
  "shippable": null,
  "sku": "my-first-product-10",
  "statement_descriptor": null,
  "tax_code": null,
  "type": "service",
  "unit_label": null,
  "updated": 1668198126,
  "url": null
}
```

Luego, llama a [Crear un precio](https://docs.stripe.com/api/prices/create.md) para adjuntar un precio de USD 30. Intercambia el marcador de posición en `product` con el identificador del producto (por ejemplo, `prod_LTenIrmp8Q67sa`).

#### bash

```bash
stripe prices create \
  --unit-amount=3000 \
  --currency=usd \
  --product="{{PRODUCT_ID}}"
```

Si todo funcionó, la línea de comandos muestra la siguiente respuesta.

#### bash

```json
{
  "id": "price_1KzlAMJJDeE9fu01WMJJr79o", // El identificador se ve de esta manera.
  "object": "price",
  "active": true,
  "billing_scheme": "per_unit",
  "created": 1652636348,
  "currency": "usd",
  "livemode": false,
  "lookup_key": null,
  "metadata": {},
  "nickname": null,
  "product": "prod_Lh9iTGZhb2mcBy",
  "recurring": null,
  "tax_behavior": "unspecified",
  "tiers_mode": null,
  "transform_quantity": null,
  "type": "one_time",
  "unit_amount": 3000,
  "unit_amount_decimal": "3000"
}
```

## Gestionar dependencias de terceros

Te recomendamos que gestiones las dependencias de terceros mediante el uso de la herramienta de línea de comandos [RubyGems](http://rubygems.org/), lo que te permite agregar nuevas bibliotecas e incluirlas en tus proyectos de Ruby. Comprueba si RubyGems está instalado:

### Instala RubyGems

#### Instala RubyGems

```bash
gem --version
```

Si aparece `gem: command not found`, [descarga RubyGems](http://rubygems.org/pages/download) desde la página de descargas.

## Instalar el SDK del lado del servidor de Ruby

La última versión del SDK del lado del servidor de Ruby de Stripe es v18.4.0. Admite las versiones 2.3 y posteriores de Ruby.

Verifica tu versión de Ruby:

```bash
ruby -v
```

### Instala la biblioteca

[Crea un archivo GEM](https://guides.rubygems.org/make-your-own-gem/) e instala la GEM generada usando un bundler con [RubyGems](https://rubygems.org/).

Agrega la última versión de la [gema de Stripe](https://rubygems.org/gems/stripe) a un proyecto:

```bash
bundle add stripe
```

Instala las gemas requeridas de las fuentes especificadas:

```bash
bundle install
```

### Alternativas de instalación

**Añadir como dependencia** —Añade la última versión de la biblioteca como una dependencia de GEM:

```ruby
source 'https://rubygems.org'

gem 'rails'
gem 'stripe'
```

**Instalación global**—Instala la biblioteca globalmente con [RubyGems](https://rubygems.org/):

```bash
gem install stripe
```

**Instalación manual**—[Crea la gema desde la fuente](https://github.com/stripe/stripe-ruby), y luego instala la biblioteca ejecutando:

```bash
gem build stripe.gemspec
```

## Ejecuta tu primera solicitud de SDK

Ahora que tienes el SDK de Ruby instalado, puedes crear un [producto](https://docs.stripe.com/api/products/create.md) de suscripción y adjuntar un [precio](https://docs.stripe.com/api/prices/create.md) con un par de solicitudes de la API. En este ejemplo, usamos el identificador del producto devuelto en la respuesta para crear el precio.

> En este ejemplo, se usan las claves predeterminadas de tu [cuenta](https://docs.stripe.com/get-started/account/activate.md) de usuario de Stripe para tu *entorno de prueba* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes). Solo tú puedes ver estos valores.

#### Crear un producto y un precio

```ruby
require 'rubygems'
require 'stripe'
Stripe.api_key = "sk_test_BQokikJOvBiI2HlWgH4olfQ2"

starter_subscription = Stripe::Product.create(
  name: 'Starter Subscription',
  description: '$12/Month subscription',
)

starter_subscription_price = Stripe::Price.create(
  currency: 'usd',
  unit_amount: 1200,
  recurring: {interval: 'month'},
  product: starter_subscription['id'],
)

puts "Success! Here is your starter subscription product id: #{starter_subscription.id}"
puts "Success! Here is your starter subscription price id: #{starter_subscription_price.id}"
```

Guarda el archivo como `create_price.rb`. Desde la línea de comandos, `cd` al directorio que contiene el archivo que acabas de guardar y ejecuta:

#### create_price.rb

```bash
ruby create_price.rb
```

Si todo funcionó, la línea de comandos muestra la siguiente respuesta. Guarda estos identificadores para poder usarlos mientras creas tu integración.

#### bash

```bash
Success! Here is your starter subscription product id: prod_0KxBDl589O8KAxCG1alJgiA6
Success! Here is your starter subscription price id: price_0KxBDm589O8KAxCGMgG7scjb
```

## See also

Esto concluye el inicio rápido. Consulta los siguientes enlaces para conocer algunas formas diferentes de procesar un pago para el producto que acabas de crear.

- [Crea un enlace de pago](https://docs.stripe.com/payment-links.md)
- [Página alojada en Stripe](https://docs.stripe.com/checkout/quickstart.md)
- [Integración avanzada](https://docs.stripe.com/payments/quickstart-checkout-sessions.md)


# Python

> This is a Python for when lang is python. View the full page at https://docs.stripe.com/get-started/development-environment?lang=python.

En este QuickStart, instala [la CLI de Stripe](https://docs.stripe.com/stripe-cli.md), una herramienta esencial que te proporciona acceso a la línea de comandos para tu integración de Stripe. También instalarás el [Stripe Python server-side SDK](https://github.com/stripe/stripe-python) para obtener acceso a las API de Stripe desde solicitudes escritas en Python.

## Lo que aprendes

En este inicio rápido, aprenderás a:

- Cómo llamar a las API de Stripe sin escribir una línea de código
- Cómo gestionar dependencias de terceros mediante el uso de un entorno virtual y el administrador de paquetes pip
- Cómo instalar el último SDK de Python de Stripe v14.4.0
- Cómo enviar tu primera solicitud de SDK

## Configuración inicial

Primero, [crea una cuenta de Stripe](https://dashboard.stripe.com/register) o [inicia sesión](https://dashboard.stripe.com/login).

## Configurar la CLI de Stripe

### Instalar

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. Luego, instala la CLI.

#### homebrew

Para instalar la CLI de Stripe con [homebrew](https://brew.sh/), ejecuta el siguiente comando:

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

Este comando falla si lo ejecutas en la versión de Linux de homebrew, pero puedes usar esta alternativa o seguir las instrucciones de la pestaña Linux.

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

#### apt

> La compilación Debian para la CLI está disponible en JFrog en https://packages.stripe.dev, que no es un dominio de la propiedad de Stripe. Cuando visites esta URL, te redirigirá a la lista de artefactos de Jfrog.

Para instalar la CLI de Stripe en distribuciones basadas en Ubuntu y en Debian:

1. Add Stripe CLI’s GPG key to the apt sources keyring:

```bash
curl -s https://packages.stripe.dev/api/security/keypair/stripe-cli-gpg/public | gpg --dearmor | sudo tee /usr/share/keyrings/stripe.gpg
```

1. Agrega 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 compilación RPM para la CLI está disponible en JFrog en https://packages.stripe.dev, que no es un dominio de la propiedad de Stripe. Cuando visites esta URL, te redirigirá a la lista de artefactos de Jfrog.

Para instalar la CLI de Stripe en distribuciones basadas en RPM:

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 el siguiente comando:

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

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

Otra opción es 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:

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. Agrega la ruta que lleva al archivo `stripe.exe` descomprimido 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).

> De vez en cuando, los detectores antivirus de Windows marcan la CLI de Stripe como no segura. Es probable que se trate de un falso positivo. Para obtener más información, consulta [problema n.º 692](https://github.com/stripe/stripe-cli/issues/692) en el repositorio de GitHub.

1. Ejecuta el archivo `.exe` descomprimido.

#### 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 el siguiente comando:

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

### Autenticar

Inicie sesión y autentique tu [cuenta](https://docs.stripe.com/get-started/account/activate.md) de usuario de Stripe para generar un conjunto de claves restringidas. Para obtener más información, consulte [Claves y permisos de la CLI de Stripe](https://docs.stripe.com/stripe-cli/keys.md).

```bash
  stripe login
```

Presiona la tecla **Enter** en tu teclado para completar el proceso de autenticación en tu 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)
```

### Confirmar configuración

Ahora que has instalado la CLI, puedes realizar una sola solicitud de API para [Crear un producto](https://docs.stripe.com/api/products/create.md).

#### bash

```bash
stripe products create \
--name="My First Product" \
--description="Created with the Stripe CLI"
```

Busca el identificador del producto (en `id`) en el objeto de respuesta. Guárdalo para el próximo paso.

Si todo funcionó, la línea de comandos muestra la siguiente respuesta.

#### bash

```json
{
  "id": "prod_LTenIrmp8Q67sa", // El identificador se ve de esta manera.
  "object": "product",
  "active": true,
  "attributes": [],
  "created": 1668198126,
  "default_price": null,
  "description": "Created with the Stripe CLI",
  "identifiers": {},
  "images": [],
  "livemode": false,
  "metadata": {},
  "name": "My First Product",
  "package_dimensions": null,
  "price": null,
  "product_class": null,
  "shippable": null,
  "sku": "my-first-product-10",
  "statement_descriptor": null,
  "tax_code": null,
  "type": "service",
  "unit_label": null,
  "updated": 1668198126,
  "url": null
}
```

Luego, llama a [Crear un precio](https://docs.stripe.com/api/prices/create.md) para adjuntar un precio de USD 30. Intercambia el marcador de posición en `product` con el identificador del producto (por ejemplo, `prod_LTenIrmp8Q67sa`).

#### bash

```bash
stripe prices create \
  --unit-amount=3000 \
  --currency=usd \
  --product="{{PRODUCT_ID}}"
```

Si todo funcionó, la línea de comandos muestra la siguiente respuesta.

#### bash

```json
{
  "id": "price_1KzlAMJJDeE9fu01WMJJr79o", // El identificador se ve de esta manera.
  "object": "price",
  "active": true,
  "billing_scheme": "per_unit",
  "created": 1652636348,
  "currency": "usd",
  "livemode": false,
  "lookup_key": null,
  "metadata": {},
  "nickname": null,
  "product": "prod_Lh9iTGZhb2mcBy",
  "recurring": null,
  "tax_behavior": "unspecified",
  "tiers_mode": null,
  "transform_quantity": null,
  "type": "one_time",
  "unit_amount": 3000,
  "unit_amount_decimal": "3000"
}
```

## Gestionar dependencias de terceros

Te recomendamos que gestiones las dependencias de terceros mediante el uso del módulo [venv](https://docs.python.org/3/tutorial/venv.html), lo que te permite agregar nuevas bibliotecas e incluirlas en tus proyectos de Python 3.

### En Windows (cmd.exe):

#### En Windows (cmd.exe)

```bash
python3 -m venv env
.\env\Scripts\activate.bat
```

### En GNU/Linux o MacOS (bash):

#### En GNU/Linux o MacOS (bash)

```bash
python3 -m venv env
source env/bin/activate
```

## Instalar el SDK del lado del servidor de Python

La última versión del SDK del lado del servidor de Python de Stripe es v14.4.0. Admite las versiones de Python 3.6+.

Verifica tu versión de Python:

```bash
python3 --version
```

### Instala la biblioteca

Instala la biblioteca desde [PyPi](http://pypi.python.org/pypi/stripe/), un gestor de paquetes para Python:

```bash
pip3 install --upgrade stripe
```

A continuación, especifica la siguiente versión en tu archivo requirements.txt:

```txt
stripe>=14.4.0
```

### Alternativas de instalación

**Instalación manual**—[Descarga el código fuente](https://github.com/stripe/stripe-python) para el SDK e instala la biblioteca ejecutando lo siguiente:

```bash
python3 setup.py install
```

## Ejecuta tu primera solicitud de SDK

Ahora que tienes instalado el SDK de Python, puedes crear un [producto](https://docs.stripe.com/api/products/create.md) de suscripción y adjuntar un [precio](https://docs.stripe.com/api/prices/create.md) con un par de solicitudes de la API. En este ejemplo, usamos el identificador del producto devuelto en la respuesta para crear el precio.

> En este ejemplo, se usan las claves predeterminadas de tu [cuenta](https://docs.stripe.com/get-started/account/activate.md) de usuario de Stripe para tu *entorno de prueba* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes). Solo tú puedes ver estos valores.

#### Crear un producto y un precio

```python
import stripe
stripe.api_key = "sk_test_BQokikJOvBiI2HlWgH4olfQ2"

starter_subscription = stripe.Product.create(
  name="Starter Subscription",
  description="$12/Month subscription",
)

starter_subscription_price = stripe.Price.create(
  unit_amount=1200,
  currency="usd",
  recurring={"interval": "month"},
  product=starter_subscription['id'],
)

# Save these identifiers
print(f"Success! Here is your starter subscription product id: {starter_subscription.id}")
print(f"Success! Here is your starter subscription price id: {starter_subscription_price.id}")
```

Guarda el archivo como `create_price.py`. Desde la línea de comandos, `cd` al directorio que contiene el archivo que acabas de guardar y ejecuta:

#### create_price.py

```bash
python3 create_price.py
```

Si todo funcionó, la línea de comandos muestra la siguiente respuesta. Guarda estos identificadores para poder usarlos mientras creas tu integración.

#### bash

```bash
Success! Here is your starter subscription product id: prod_0KxBDl589O8KAxCG1alJgiA6
Success! Here is your starter subscription price id: price_0KxBDm589O8KAxCGMgG7scjb
```

## See also

Esto concluye el inicio rápido. Consulta los siguientes enlaces para conocer algunas formas diferentes de procesar un pago para el producto que acabas de crear.

- [Crea un enlace de pago](https://docs.stripe.com/payment-links.md)
- [Página alojada en Stripe](https://docs.stripe.com/checkout/quickstart.md)
- [Integración avanzada](https://docs.stripe.com/payments/quickstart-checkout-sessions.md)


# Ir

> This is a Ir for when lang is go. View the full page at https://docs.stripe.com/get-started/development-environment?lang=go.

En este QuickStart, instala [la CLI de Stripe](https://docs.stripe.com/stripe-cli.md), una herramienta esencial que te da acceso a la línea de comandos para tu integración de Stripe. También instalarás [Stripe Go server-side SDK](https://github.com/stripe/stripe-go) para obtener acceso a las API de Stripe desde solicitudes escritas en Go.

## Lo que aprendes

En este inicio rápido, aprenderás a:

- Cómo llamar a las API de Stripe sin escribir una línea de código
- Cómo gestionar dependencias de terceros mediante el uso de los módulos Go
- Cómo instalar la última versión del SDK de Stripe Go v84.4.0
- Cómo enviar tu primera solicitud de SDK

## Configuración inicial

Primero, [crea una cuenta de Stripe](https://dashboard.stripe.com/register) o [inicia sesión](https://dashboard.stripe.com/login).

## Configurar la CLI de Stripe

### Instalar

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. Luego, instala la CLI.

#### homebrew

Para instalar la CLI de Stripe con [homebrew](https://brew.sh/), ejecuta el siguiente comando:

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

Este comando falla si lo ejecutas en la versión de Linux de homebrew, pero puedes usar esta alternativa o seguir las instrucciones de la pestaña Linux.

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

#### apt

> La compilación Debian para la CLI está disponible en JFrog en https://packages.stripe.dev, que no es un dominio de la propiedad de Stripe. Cuando visites esta URL, te redirigirá a la lista de artefactos de Jfrog.

Para instalar la CLI de Stripe en distribuciones basadas en Ubuntu y en Debian:

1. Add Stripe CLI’s GPG key to the apt sources keyring:

```bash
curl -s https://packages.stripe.dev/api/security/keypair/stripe-cli-gpg/public | gpg --dearmor | sudo tee /usr/share/keyrings/stripe.gpg
```

1. Agrega 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 compilación RPM para la CLI está disponible en JFrog en https://packages.stripe.dev, que no es un dominio de la propiedad de Stripe. Cuando visites esta URL, te redirigirá a la lista de artefactos de Jfrog.

Para instalar la CLI de Stripe en distribuciones basadas en RPM:

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 el siguiente comando:

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

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

Otra opción es 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:

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. Agrega la ruta que lleva al archivo `stripe.exe` descomprimido 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).

> De vez en cuando, los detectores antivirus de Windows marcan la CLI de Stripe como no segura. Es probable que se trate de un falso positivo. Para obtener más información, consulta [problema n.º 692](https://github.com/stripe/stripe-cli/issues/692) en el repositorio de GitHub.

1. Ejecuta el archivo `.exe` descomprimido.

#### 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 el siguiente comando:

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

### Autenticar

Inicie sesión y autentique tu [cuenta](https://docs.stripe.com/get-started/account/activate.md) de usuario de Stripe para generar un conjunto de claves restringidas. Para obtener más información, consulte [Claves y permisos de la CLI de Stripe](https://docs.stripe.com/stripe-cli/keys.md).

```bash
  stripe login
```

Presiona la tecla **Enter** en tu teclado para completar el proceso de autenticación en tu 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)
```

### Confirmar configuración

Ahora que has instalado la CLI, puedes realizar una sola solicitud de API para [Crear un producto](https://docs.stripe.com/api/products/create.md).

#### bash

```bash
stripe products create \
--name="My First Product" \
--description="Created with the Stripe CLI"
```

Busca el identificador del producto (en `id`) en el objeto de respuesta. Guárdalo para el próximo paso.

Si todo funcionó, la línea de comandos muestra la siguiente respuesta.

#### bash

```json
{
  "id": "prod_LTenIrmp8Q67sa", // El identificador se ve de esta manera.
  "object": "product",
  "active": true,
  "attributes": [],
  "created": 1668198126,
  "default_price": null,
  "description": "Created with the Stripe CLI",
  "identifiers": {},
  "images": [],
  "livemode": false,
  "metadata": {},
  "name": "My First Product",
  "package_dimensions": null,
  "price": null,
  "product_class": null,
  "shippable": null,
  "sku": "my-first-product-10",
  "statement_descriptor": null,
  "tax_code": null,
  "type": "service",
  "unit_label": null,
  "updated": 1668198126,
  "url": null
}
```

Luego, llama a [Crear un precio](https://docs.stripe.com/api/prices/create.md) para adjuntar un precio de USD 30. Intercambia el marcador de posición en `product` con el identificador del producto (por ejemplo, `prod_LTenIrmp8Q67sa`).

#### bash

```bash
stripe prices create \
  --unit-amount=3000 \
  --currency=usd \
  --product="{{PRODUCT_ID}}"
```

Si todo funcionó, la línea de comandos muestra la siguiente respuesta.

#### bash

```json
{
  "id": "price_1KzlAMJJDeE9fu01WMJJr79o", // El identificador se ve de esta manera.
  "object": "price",
  "active": true,
  "billing_scheme": "per_unit",
  "created": 1652636348,
  "currency": "usd",
  "livemode": false,
  "lookup_key": null,
  "metadata": {},
  "nickname": null,
  "product": "prod_Lh9iTGZhb2mcBy",
  "recurring": null,
  "tax_behavior": "unspecified",
  "tiers_mode": null,
  "transform_quantity": null,
  "type": "one_time",
  "unit_amount": 3000,
  "unit_amount_decimal": "3000"
}
```

## Gestionar dependencias de terceros

Te recomendamos que gestiones las dependencias de terceros mediante el uso de [módulos Go](https://go.dev/blog/using-go-modules), lo que te permite agregar nuevas bibliotecas e incluirlas en tus proyectos de Go.

### Inicializa Go

Si empiezas de cero en un nuevo directorio, primero debes crear un archivo `go.mod` para hacer el seguimiento de las dependencias. Por ejemplo:

#### Inicializa Go

```bash
go mod init stripe-example
```

## Instalar el SDK del lado del servidor de Go

La última versión del SDK del lado del servidor de Stripe Go es v84.4.0. Es compatible con las versiones de Go 1.15+.

### Instala la biblioteca

Instala la biblioteca con [módulos Go](https://go.dev/blog/using-go-modules), un administrador de paquetes para Go:

```bash
go get github.com/stripe/stripe-go/v84
```

Después de instalar la biblioteca con los módulos Go en un proyecto *nuevo*, la biblioteca se agrega automáticamente como una dependencia en el archivo go.mod del proyecto. Por ejemplo:

```go.mod
module stripe-example

go 1.18

require github.com/stripe/stripe-go/v84 84.4.0 // indirect
```

### Sincronizar dependencias

Para mantener ordenado el conjunto de dependencias administradas de un proyecto *existente*, ejecuta el siguiente comando para [sincronizar las dependencias de tu código](https://go.dev/doc/modules/managing-dependencies).

```bash
go mod tidy
```

## Ejecuta tu primera solicitud de SDK

Ahora que tienes instalado el SDK de Go, puedes crear un [producto](https://docs.stripe.com/api/products/create.md) de suscripción y adjuntar un [precio](https://docs.stripe.com/api/prices/create.md) con un par de solicitudes de la API. En este ejemplo, usamos el identificador del producto devuelto en la respuesta para crear el precio.

> En este ejemplo, se usan las claves predeterminadas de tu [cuenta](https://docs.stripe.com/get-started/account/activate.md) de usuario de Stripe para tu *entorno de prueba* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes). Solo tú puedes ver estos valores.

#### Crear un producto y un precio

```go
package main

import (
  "fmt"
  "github.com/stripe/stripe-go/v84"
  "github.com/stripe/stripe-go/v84/product"
  "github.com/stripe/stripe-go/v84/price"
)

func main() {
  stripe.Key = "sk_test_BQokikJOvBiI2HlWgH4olfQ2"

	product_params := &stripe.ProductParams{
		Name:        stripe.String("Starter Subscription"),
		Description: stripe.String("$12/Month subscription"),
	}
	starter_product, _ := product.New(product_params)

	price_params := &stripe.PriceParams{
		Currency: stripe.String(string(stripe.CurrencyUSD)),
		Product:  stripe.String(starter_product.ID),
		Recurring: &stripe.PriceRecurringParams{
			Interval: stripe.String(string(stripe.PriceRecurringIntervalMonth)),
		},
		UnitAmount: stripe.Int64(1200),
	}
	starter_price, _ := price.New(price_params)

	fmt.Println("Success! Here is your starter subscription product id: " + starter_product.ID)
	fmt.Println("Success! Here is your starter subscription price id: " + starter_price.ID)
}
```

Guarda el archivo como `create_price.go`. Desde la línea de comandos, `cd` al directorio que contiene el archivo que acabas de guardar y ejecuta:

#### create_price.rb

```bash
go run create_price.go
```

Si todo funcionó, la línea de comandos muestra la siguiente respuesta. Guarda estos identificadores para poder usarlos mientras creas tu integración.

#### bash

```bash
Success! Here is your starter subscription product id: prod_0KxBDl589O8KAxCG1alJgiA6
Success! Here is your starter subscription price id: price_0KxBDm589O8KAxCGMgG7scjb
```

## See also

Esto concluye el inicio rápido. Consulta los siguientes enlaces para conocer algunas formas diferentes de procesar un pago para el producto que acabas de crear.

- [Crea un enlace de pago](https://docs.stripe.com/payment-links.md)
- [Página alojada en Stripe](https://docs.stripe.com/checkout/quickstart.md)
- [Integración avanzada](https://docs.stripe.com/payments/quickstart-checkout-sessions.md)


# Java

> This is a Java for when lang is java. View the full page at https://docs.stripe.com/get-started/development-environment?lang=java.

En este QuickStart, instala [la CLI de Stripe](https://docs.stripe.com/stripe-cli.md), una herramienta esencial que te proporciona acceso a la línea de comandos para tu integración de Stripe. También instalarás el [Stripe Java server-side SDK](https://github.com/stripe/stripe-java) para obtener acceso a las API de Stripe desde solicitudes escritas en Java.

## Lo que aprendes

En este inicio rápido, aprenderás a:

- Cómo llamar a las API de Stripe sin escribir una línea de código
- Cómo gestionar dependencias de terceros mediante el uso de Maven o Gradle
- Cómo instalar el último SDK de Stripe Java v31.4.0
- Cómo enviar tu primera solicitud de SDK

## Configuración inicial

Primero, [crea una cuenta de Stripe](https://dashboard.stripe.com/register) o [inicia sesión](https://dashboard.stripe.com/login).

## Configurar la CLI de Stripe

### Instalar

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. Luego, instala la CLI.

#### homebrew

Para instalar la CLI de Stripe con [homebrew](https://brew.sh/), ejecuta el siguiente comando:

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

Este comando falla si lo ejecutas en la versión de Linux de homebrew, pero puedes usar esta alternativa o seguir las instrucciones de la pestaña Linux.

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

#### apt

> La compilación Debian para la CLI está disponible en JFrog en https://packages.stripe.dev, que no es un dominio de la propiedad de Stripe. Cuando visites esta URL, te redirigirá a la lista de artefactos de Jfrog.

Para instalar la CLI de Stripe en distribuciones basadas en Ubuntu y en Debian:

1. Add Stripe CLI’s GPG key to the apt sources keyring:

```bash
curl -s https://packages.stripe.dev/api/security/keypair/stripe-cli-gpg/public | gpg --dearmor | sudo tee /usr/share/keyrings/stripe.gpg
```

1. Agrega 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 compilación RPM para la CLI está disponible en JFrog en https://packages.stripe.dev, que no es un dominio de la propiedad de Stripe. Cuando visites esta URL, te redirigirá a la lista de artefactos de Jfrog.

Para instalar la CLI de Stripe en distribuciones basadas en RPM:

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 el siguiente comando:

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

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

Otra opción es 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:

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. Agrega la ruta que lleva al archivo `stripe.exe` descomprimido 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).

> De vez en cuando, los detectores antivirus de Windows marcan la CLI de Stripe como no segura. Es probable que se trate de un falso positivo. Para obtener más información, consulta [problema n.º 692](https://github.com/stripe/stripe-cli/issues/692) en el repositorio de GitHub.

1. Ejecuta el archivo `.exe` descomprimido.

#### 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 el siguiente comando:

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

### Autenticar

Inicie sesión y autentique tu [cuenta](https://docs.stripe.com/get-started/account/activate.md) de usuario de Stripe para generar un conjunto de claves restringidas. Para obtener más información, consulte [Claves y permisos de la CLI de Stripe](https://docs.stripe.com/stripe-cli/keys.md).

```bash
  stripe login
```

Presiona la tecla **Enter** en tu teclado para completar el proceso de autenticación en tu 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)
```

### Confirmar configuración

Ahora que has instalado la CLI, puedes realizar una sola solicitud de API para [Crear un producto](https://docs.stripe.com/api/products/create.md).

#### bash

```bash
stripe products create \
--name="My First Product" \
--description="Created with the Stripe CLI"
```

Busca el identificador del producto (en `id`) en el objeto de respuesta. Guárdalo para el próximo paso.

Si todo funcionó, la línea de comandos muestra la siguiente respuesta.

#### bash

```json
{
  "id": "prod_LTenIrmp8Q67sa", // El identificador se ve de esta manera.
  "object": "product",
  "active": true,
  "attributes": [],
  "created": 1668198126,
  "default_price": null,
  "description": "Created with the Stripe CLI",
  "identifiers": {},
  "images": [],
  "livemode": false,
  "metadata": {},
  "name": "My First Product",
  "package_dimensions": null,
  "price": null,
  "product_class": null,
  "shippable": null,
  "sku": "my-first-product-10",
  "statement_descriptor": null,
  "tax_code": null,
  "type": "service",
  "unit_label": null,
  "updated": 1668198126,
  "url": null
}
```

Luego, llama a [Crear un precio](https://docs.stripe.com/api/prices/create.md) para adjuntar un precio de USD 30. Intercambia el marcador de posición en `product` con el identificador del producto (por ejemplo, `prod_LTenIrmp8Q67sa`).

#### bash

```bash
stripe prices create \
  --unit-amount=3000 \
  --currency=usd \
  --product="{{PRODUCT_ID}}"
```

Si todo funcionó, la línea de comandos muestra la siguiente respuesta.

#### bash

```json
{
  "id": "price_1KzlAMJJDeE9fu01WMJJr79o", // El identificador se ve de esta manera.
  "object": "price",
  "active": true,
  "billing_scheme": "per_unit",
  "created": 1652636348,
  "currency": "usd",
  "livemode": false,
  "lookup_key": null,
  "metadata": {},
  "nickname": null,
  "product": "prod_Lh9iTGZhb2mcBy",
  "recurring": null,
  "tax_behavior": "unspecified",
  "tiers_mode": null,
  "transform_quantity": null,
  "type": "one_time",
  "unit_amount": 3000,
  "unit_amount_decimal": "3000"
}
```

## Gestionar dependencias de terceros

Recomendamos administrar las dependencias de terceros con [Maven](https://maven.apache.org/guides/getting-started/index.html) o [Gradle](https://docs.gradle.org), que te ayudan a agregar nuevas bibliotecas e incluirlas en tus proyectos de Java.

### Inicializa un proyecto

- Para crear un proyecto con **Maven**, consulta [¿Cómo puedo crear mi primer proyecto con Maven?](https://maven.apache.org/guides/getting-started/index.html#How_do_I_make_my_first_Maven_project).
- Para crear un proyecto con **Gradle**, consulta [Crear una muestra de aplicaciones de Java](https://docs.gradle.org/current/samples/sample_building_java_applications.html).

## Instalar el SDK del lado del servidor de Java

La última versión del SDK del lado del servidor de Java de Stripe es v31.4.0. Admite las versiones 1.8 y posteriores de Java.

Verifica tu versión de Java:

```bash
java -version
```

### Instala la biblioteca

- Con **Maven**, coloca lo siguiente en el archivo pom.xml de tu proyecto:

```xml
<dependency>
  <groupId>com.stripe</groupId>
  <artifactId>stripe-java</artifactId>
  <version>31.4.0</version>
</dependency>
```

- Con **Gradle**, pega la siguiente línea dentro del bloque de dependencias de tu archivo build.gradle:

```groovy
implementation 'com.stripe:stripe-java:31.4.0'
```

### Alternativas de instalación

**Instalación manual**—Puedes instalar manualmente stripe-java con los siguientes JAR: [Descarga el archivo JAR (.jar) de Stripe](https://search.maven.org/remote_content?g=com.stripe&a=stripe-java&v=LATEST).

[Descargar el archivo JAR (.jar) de Gson](https://repo1.maven.org/maven2/com/google/code/gson/gson/2.8.9/gson-2.8.9.jar) para [Gson de Google](https://github.com/google/gson).

**Proguard**—Si estás usando ProGuard, asegúrate de excluir la biblioteca agregando lo siguiente a tu archivo `proguard.cfg`:

```proguard
-keep class com.stripe.** { *; }
```

## Ejecuta tu primera solicitud de SDK

Ahora que tienes instalado el SDK de Java, puedes crear un [producto](https://docs.stripe.com/api/products/create.md) de suscripción y adjuntar un [precio](https://docs.stripe.com/api/prices/create.md) con un par de solicitudes de la API. En este ejemplo, usamos el identificador del producto devuelto en la respuesta para crear el precio.

> En este ejemplo, se usan las claves predeterminadas de tu [cuenta](https://docs.stripe.com/get-started/account/activate.md) de usuario de Stripe para tu *entorno de prueba* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes). Solo tú puedes ver estos valores.

#### Crear un producto y un precio

```java
package com.stripe.sample;

import com.stripe.Stripe;
import com.stripe.exception.StripeException;
import com.stripe.model.Product;
import com.stripe.param.ProductCreateParams;
import com.stripe.param.PriceCreateParams;
import com.stripe.model.Price;

public class Server {
    public static void main(String[] args) throws StripeException {
        Stripe.apiKey = "sk_test_BQokikJOvBiI2HlWgH4olfQ2";


        ProductCreateParams productParams =
            ProductCreateParams.builder()
                .setName("Starter Subscription")
                .setDescription("$12/Month subscription")
                .build();
        Product product = Product.create(productParams);
        System.out.println("Success! Here is your starter subscription product id: " + product.getId());

        PriceCreateParams params =
            PriceCreateParams
                .builder()
                .setProduct(product.getId())
                .setCurrency("usd")
                .setUnitAmount(1200L)
                .setRecurring(
                    PriceCreateParams.Recurring
                        .builder()
                        .setInterval(PriceCreateParams.Recurring.Interval.MONTH)
                        .build())
                .build();
        Price price = Price.create(params);
        System.out.println("Success! Here is your starter subscription price id: " + price.getId());
    }
}
```

Guarda el archivo como `CreatePrice.java`. Desde el proyecto en tu IDE para Maven o Gradle, ejecuta la muestra. Por ejemplo: `Run 'CreatePrice.main()'`.

Si todo funcionó, la línea de comandos muestra la siguiente respuesta. Guarda estos identificadores para poder usarlos mientras creas tu integración.

#### bash

```bash
Success! Here is your starter subscription product id: prod_0KxBDl589O8KAxCG1alJgiA6
Success! Here is your starter subscription price id: price_0KxBDm589O8KAxCGMgG7scjb
```

## See also

Esto concluye el inicio rápido. Consulta los siguientes enlaces para conocer algunas formas diferentes de procesar un pago para el producto que acabas de crear.

- [Crea un enlace de pago](https://docs.stripe.com/payment-links.md)
- [Página alojada en Stripe](https://docs.stripe.com/checkout/quickstart.md)
- [Integración avanzada](https://docs.stripe.com/payments/quickstart-checkout-sessions.md)


# Node.js

> This is a Node.js for when lang is node. View the full page at https://docs.stripe.com/get-started/development-environment?lang=node.

En este QuickStart, instala [la CLI de Stripe](https://docs.stripe.com/stripe-cli.md), una herramienta esencial que te proporciona acceso a la línea de comandos para tu integración de Stripe. También instalarás[Stripe Node.js server-side SDK](https://github.com/stripe/stripe-node) para obtener acceso a las API de Stripe desde solicitudes escritas en Node.js.

## Lo que aprendes

En este inicio rápido, aprenderás a:

- Cómo llamar a las API de Stripe sin escribir una línea de código
- Cómo gestionar dependencias de terceros mediante el uso del administrador de paquetes de npm o hilo
- Cómo instalar el último SDK de Stripe Node v20.4.0
- Cómo enviar tu primera solicitud de SDK

## Configuración inicial

Primero, [crea una cuenta de Stripe](https://dashboard.stripe.com/register) o [inicia sesión](https://dashboard.stripe.com/login).

## Configurar la CLI de Stripe

### Instalar

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. Luego, instala la CLI.

#### homebrew

Para instalar la CLI de Stripe con [homebrew](https://brew.sh/), ejecuta el siguiente comando:

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

Este comando falla si lo ejecutas en la versión de Linux de homebrew, pero puedes usar esta alternativa o seguir las instrucciones de la pestaña Linux.

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

#### apt

> La compilación Debian para la CLI está disponible en JFrog en https://packages.stripe.dev, que no es un dominio de la propiedad de Stripe. Cuando visites esta URL, te redirigirá a la lista de artefactos de Jfrog.

Para instalar la CLI de Stripe en distribuciones basadas en Ubuntu y en Debian:

1. Add Stripe CLI’s GPG key to the apt sources keyring:

```bash
curl -s https://packages.stripe.dev/api/security/keypair/stripe-cli-gpg/public | gpg --dearmor | sudo tee /usr/share/keyrings/stripe.gpg
```

1. Agrega 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 compilación RPM para la CLI está disponible en JFrog en https://packages.stripe.dev, que no es un dominio de la propiedad de Stripe. Cuando visites esta URL, te redirigirá a la lista de artefactos de Jfrog.

Para instalar la CLI de Stripe en distribuciones basadas en RPM:

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 el siguiente comando:

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

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

Otra opción es 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:

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. Agrega la ruta que lleva al archivo `stripe.exe` descomprimido 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).

> De vez en cuando, los detectores antivirus de Windows marcan la CLI de Stripe como no segura. Es probable que se trate de un falso positivo. Para obtener más información, consulta [problema n.º 692](https://github.com/stripe/stripe-cli/issues/692) en el repositorio de GitHub.

1. Ejecuta el archivo `.exe` descomprimido.

#### 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 el siguiente comando:

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

### Autenticar

Inicie sesión y autentique tu [cuenta](https://docs.stripe.com/get-started/account/activate.md) de usuario de Stripe para generar un conjunto de claves restringidas. Para obtener más información, consulte [Claves y permisos de la CLI de Stripe](https://docs.stripe.com/stripe-cli/keys.md).

```bash
  stripe login
```

Presiona la tecla **Enter** en tu teclado para completar el proceso de autenticación en tu 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)
```

### Confirmar configuración

Ahora que has instalado la CLI, puedes realizar una sola solicitud de API para [Crear un producto](https://docs.stripe.com/api/products/create.md).

#### bash

```bash
stripe products create \
--name="My First Product" \
--description="Created with the Stripe CLI"
```

Busca el identificador del producto (en `id`) en el objeto de respuesta. Guárdalo para el próximo paso.

Si todo funcionó, la línea de comandos muestra la siguiente respuesta.

#### bash

```json
{
  "id": "prod_LTenIrmp8Q67sa", // El identificador se ve de esta manera.
  "object": "product",
  "active": true,
  "attributes": [],
  "created": 1668198126,
  "default_price": null,
  "description": "Created with the Stripe CLI",
  "identifiers": {},
  "images": [],
  "livemode": false,
  "metadata": {},
  "name": "My First Product",
  "package_dimensions": null,
  "price": null,
  "product_class": null,
  "shippable": null,
  "sku": "my-first-product-10",
  "statement_descriptor": null,
  "tax_code": null,
  "type": "service",
  "unit_label": null,
  "updated": 1668198126,
  "url": null
}
```

Luego, llama a [Crear un precio](https://docs.stripe.com/api/prices/create.md) para adjuntar un precio de USD&nbsp;30. Intercambia el marcador de posición en `product` con el identificador del producto (por ejemplo, `prod_LTenIrmp8Q67sa`).

#### bash

```bash
stripe prices create \
  --unit-amount=3000 \
  --currency=usd \
  --product="{{PRODUCT_ID}}"
```

Si todo funcionó, la línea de comandos muestra la siguiente respuesta.

#### bash

```json
{
  "id": "price_1KzlAMJJDeE9fu01WMJJr79o", // El identificador se ve de esta manera.
  "object": "price",
  "active": true,
  "billing_scheme": "per_unit",
  "created": 1652636348,
  "currency": "usd",
  "livemode": false,
  "lookup_key": null,
  "metadata": {},
  "nickname": null,
  "product": "prod_Lh9iTGZhb2mcBy",
  "recurring": null,
  "tax_behavior": "unspecified",
  "tiers_mode": null,
  "transform_quantity": null,
  "type": "one_time",
  "unit_amount": 3000,
  "unit_amount_decimal": "3000"
}
```

## Instalar el SDK del lado del servidor de Node.js

La última versión del SDK del lado del servidor de Stripe Node.js es v20.4.0. Es compatible con las versiones de Node.js 12+.

Verifica la versión de tu nodo:

```bash
node --version
```

### Inicializar nodo

#### Inicializar nodo

```bash
npm init
```

### Instala la biblioteca

Instala la biblioteca con [npm](https://www.npmjs.com/package/node), un administrador de paquetes para Node:

```bash
npm install stripe --save
```

Después de instalar la biblioteca con npm, la biblioteca se agrega automáticamente como una dependencia en el archivo package.json del proyecto. Por ejemplo:

```json
{
  "name": "stripe-node-example",
  "version": "1.0.0",
  "description": "A Stripe demo",
  "main": "index.js",
  "scripts": {
    "node ": "node create_price.js",
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "author": "",
  "license": "ISC",
  "dependencies": {
    "stripe": "^20.4.0"
  }
}
```

### Alternativas de instalación

**Yarnpkg**—Puedes instalar la biblioteca con [yarn](https://yarnpkg.com/), otro gestor de paquetes para Node:

```bash
yarn add stripe
```

## Ejecuta tu primera solicitud de SDK

Ahora que tienes instalado el SDK Node.js, puedes crear un [producto](https://docs.stripe.com/api/products/create.md) de suscripción y adjuntar un [precio](https://docs.stripe.com/api/prices/create.md) con un par de solicitudes de la API. El SDK Node.js devuelve [promesas](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise) que se pueden usar como devoluciones de llamada encadenables. Para demostrarlo, estamos usando el identificador del producto devuelto en la respuesta del producto para crear un precio en este ejemplo.

> En este ejemplo, se usan las claves predeterminadas de tu [cuenta](https://docs.stripe.com/get-started/account/activate.md) de usuario de Stripe para tu *entorno de prueba* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes). Solo tú puedes ver estos valores.

#### Crear un producto y un precio

```node
const stripe = require('stripe')('sk_test_BQokikJOvBiI2HlWgH4olfQ2');

stripe.products.create({
  name: 'Starter Subscription',
  description: '$12/Month subscription',
}).then(product => {
  stripe.prices.create({
    unit_amount: 1200,
    currency: 'usd',
    recurring: {
      interval: 'month',
    },
    product: product.id,
  }).then(price => {
    console.log('Success! Here is your starter subscription product id: ' + product.id);
    console.log('Success! Here is your starter subscription price id: ' + price.id);
  });
});
```

Guarda el archivo como `create_price.js`. Desde la línea de comandos, `cd` al directorio que contiene el archivo que acabas de guardar y ejecuta:

#### create_price.js

```bash
node create_price.js
```

Si todo funcionó, la línea de comandos muestra la siguiente respuesta. Guarda estos identificadores para poder usarlos mientras creas tu integración.

#### bash

```bash
Success! Here is your starter subscription product id: prod_0KxBDl589O8KAxCG1alJgiA6
Success! Here is your starter subscription price id: price_0KxBDm589O8KAxCGMgG7scjb
```

## See also

Esto concluye el inicio rápido. Consulta los siguientes enlaces para conocer algunas formas diferentes de procesar un pago para el producto que acabas de crear.

- [Crea un enlace de pago](https://docs.stripe.com/payment-links.md)
- [Página alojada en Stripe](https://docs.stripe.com/checkout/quickstart.md)
- [Integración avanzada](https://docs.stripe.com/payments/quickstart-checkout-sessions.md)


# PHP

> This is a PHP for when lang is php. View the full page at https://docs.stripe.com/get-started/development-environment?lang=php.

En este QuickStart, instala [la CLI de Stripe](https://docs.stripe.com/stripe-cli.md), una herramienta esencial que te proporciona acceso a la línea de comandos para su integración de Stripe. También instalarás el [Stripe PHP server-side SDK](https://github.com/stripe/stripe-php) para obtener acceso a las API de Stripe desde solicitudes escritas en PHP.

## Lo que aprendes

En este inicio rápido, aprenderás a:

- Cómo llamar a las API de Stripe sin escribir una línea de código
- Cómo gestionar dependencias de terceros mediante el uso de Composer
- Cómo instalar el último SDK de PHP de Stripe v19.4.0
- Cómo enviar tu primera solicitud de SDK

## Configuración inicial

Primero, [crea una cuenta de Stripe](https://dashboard.stripe.com/register) o [inicia sesión](https://dashboard.stripe.com/login).

## Configurar la CLI de Stripe

### Instalar

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. Luego, instala la CLI.

#### homebrew

Para instalar la CLI de Stripe con [homebrew](https://brew.sh/), ejecuta el siguiente comando:

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

Este comando falla si lo ejecutas en la versión de Linux de homebrew, pero puedes usar esta alternativa o seguir las instrucciones de la pestaña Linux.

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

#### apt

> La compilación Debian para la CLI está disponible en JFrog en https://packages.stripe.dev, que no es un dominio de la propiedad de Stripe. Cuando visites esta URL, te redirigirá a la lista de artefactos de Jfrog.

Para instalar la CLI de Stripe en distribuciones basadas en Ubuntu y en Debian:

1. Add Stripe CLI’s GPG key to the apt sources keyring:

```bash
curl -s https://packages.stripe.dev/api/security/keypair/stripe-cli-gpg/public | gpg --dearmor | sudo tee /usr/share/keyrings/stripe.gpg
```

1. Agrega 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 compilación RPM para la CLI está disponible en JFrog en https://packages.stripe.dev, que no es un dominio de la propiedad de Stripe. Cuando visites esta URL, te redirigirá a la lista de artefactos de Jfrog.

Para instalar la CLI de Stripe en distribuciones basadas en RPM:

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 el siguiente comando:

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

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

Otra opción es 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:

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. Agrega la ruta que lleva al archivo `stripe.exe` descomprimido 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).

> De vez en cuando, los detectores antivirus de Windows marcan la CLI de Stripe como no segura. Es probable que se trate de un falso positivo. Para obtener más información, consulta [problema n.º 692](https://github.com/stripe/stripe-cli/issues/692) en el repositorio de GitHub.

1. Ejecuta el archivo `.exe` descomprimido.

#### 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 el siguiente comando:

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

### Autenticar

Inicie sesión y autentique tu [cuenta](https://docs.stripe.com/get-started/account/activate.md) de usuario de Stripe para generar un conjunto de claves restringidas. Para obtener más información, consulte [Claves y permisos de la CLI de Stripe](https://docs.stripe.com/stripe-cli/keys.md).

```bash
  stripe login
```

Presiona la tecla **Enter** en tu teclado para completar el proceso de autenticación en tu 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)
```

### Confirmar configuración

Ahora que has instalado la CLI, puedes realizar una sola solicitud de API para [Crear un producto](https://docs.stripe.com/api/products/create.md).

#### bash

```bash
stripe products create \
--name="My First Product" \
--description="Created with the Stripe CLI"
```

Busca el identificador del producto (en `id`) en el objeto de respuesta. Guárdalo para el próximo paso.

Si todo funcionó, la línea de comandos muestra la siguiente respuesta.

#### bash

```json
{
  "id": "prod_LTenIrmp8Q67sa", // El identificador se ve de esta manera.
  "object": "product",
  "active": true,
  "attributes": [],
  "created": 1668198126,
  "default_price": null,
  "description": "Created with the Stripe CLI",
  "identifiers": {},
  "images": [],
  "livemode": false,
  "metadata": {},
  "name": "My First Product",
  "package_dimensions": null,
  "price": null,
  "product_class": null,
  "shippable": null,
  "sku": "my-first-product-10",
  "statement_descriptor": null,
  "tax_code": null,
  "type": "service",
  "unit_label": null,
  "updated": 1668198126,
  "url": null
}
```

Luego, llama a [Crear un precio](https://docs.stripe.com/api/prices/create.md) para adjuntar un precio de USD&nbsp;30. Intercambia el marcador de posición en `product` con el identificador del producto (por ejemplo, `prod_LTenIrmp8Q67sa`).

#### bash

```bash
stripe prices create \
  --unit-amount=3000 \
  --currency=usd \
  --product="{{PRODUCT_ID}}"
```

Si todo funcionó, la línea de comandos muestra la siguiente respuesta.

#### bash

```json
{
  "id": "price_1KzlAMJJDeE9fu01WMJJr79o", // El identificador se ve de esta manera.
  "object": "price",
  "active": true,
  "billing_scheme": "per_unit",
  "created": 1652636348,
  "currency": "usd",
  "livemode": false,
  "lookup_key": null,
  "metadata": {},
  "nickname": null,
  "product": "prod_Lh9iTGZhb2mcBy",
  "recurring": null,
  "tax_behavior": "unspecified",
  "tiers_mode": null,
  "transform_quantity": null,
  "type": "one_time",
  "unit_amount": 3000,
  "unit_amount_decimal": "3000"
}
```

## Gestionar dependencias de terceros

Te recomendamos que administres las dependencias de terceros desde [Packagist](https://packagist.org/) mediante el uso de [Composer](https://getcomposer.org/download/), lo que te permite agregar nuevas bibliotecas e incluirlas en tus proyectos de PHP.

### Instala Composer

Desde la línea de comandos, usa las instrucciones para [descargar Composer](https://getcomposer.org/download/).

## Instalar el SDK del lado del servidor de PHP

La última versión del SDK del lado del servidor de PHP de Stripe es v19.4.0. Admite las versiones 5.6.0 y posteriores de PHP.

Verifica tu versión de PHP:

```bash
php --version
```

### Instala la biblioteca

Instala la biblioteca con [Composer](http://getcomposer.org/), un administrador de paquetes para PHP:

```bash
composer require stripe/stripe-php
```

Después de instalar la biblioteca con Composer, se agrega automáticamente como una dependencia en el archivo composer.json de tu proyecto. Por ejemplo:

```json
{
    "require": {
        "stripe/stripe-php": "^19.4.0"
    }
}
```

Para usar los enlaces, usa de Composer [autocarga](https://getcomposer.org/doc/01-basic-usage.md#autoloading). Por ejemplo:

```php
require_once('vendor/autoload.php');
```

### Alternativas de instalación

**Instalación manual**

Puedes [descargar la última versión](https://github.com/stripe/stripe-php/releases) para usar los enlaces y luego incluir el archivo init.php:

```php
require_once('/path/to/stripe-php/init.php');
```

Luego, agrega las siguientes extensiones: [cURL](https://secure.php.net/manual/en/book.curl.php) (o también puedes usar tu propio cliente que no sea Curl) [json](https://secure.php.net/manual/en/book.json.php) [mbstring](https://secure.php.net/manual/en/book.mbstring.php)

## Ejecuta tu primera solicitud de SDK

Ahora que tienes instalado el SDK de PHP, puedes crear un [producto](https://docs.stripe.com/api/products/create.md) de suscripción y adjuntar un [precio](https://docs.stripe.com/api/prices/create.md) con un par de solicitudes de la API. En este ejemplo, usamos el identificador del producto devuelto en la respuesta para crear el precio.

> En este ejemplo, se usan las claves predeterminadas de tu [cuenta](https://docs.stripe.com/get-started/account/activate.md) de usuario de Stripe para tu *entorno de prueba* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes). Solo tú puedes ver estos valores.

#### Crear un producto y un precio

```php
<?php
require_once('vendor/autoload.php');

$stripe = new \Stripe\StripeClient("sk_test_BQokikJOvBiI2HlWgH4olfQ2");

$product = $stripe->products->create([
  'name' => 'Starter Subscription',
  'description' => '$12/Month subscription',
]);
echo "Success! Here is your starter subscription product id: " . $product->id . "\n";

$price = $stripe->prices->create([
  'unit_amount' => 1200,
  'currency' => 'usd',
  'recurring' => ['interval' => 'month'],
  'product' => $product['id'],
]);
echo "Success! Here is your starter subscription price id: " . $price->id . "\n";

?>
```

Guardar el archivo como`create_price.php`. Desde la línea de comandos, `cd` al directorio que contiene el archivo que acabas de guardar y ejecuta:

#### create_price.php

```bash
php create_price.php

```

Si todo funcionó, la línea de comandos muestra la siguiente respuesta. Guarda estos identificadores para poder usarlos mientras creas tu integración.

#### bash

```bash
Success! Here is your starter subscription product id: price_0KxBDl589O8KAxCG1alJgiA6
Success! Here is your starter subscription price id: price_0KxBDm589O8KAxCGMgG7scjb
```

## See also

Esto concluye el inicio rápido. Consulta los siguientes enlaces para conocer algunas formas diferentes de procesar un pago para el producto que acabas de crear.

- [Crea un enlace de pago](https://docs.stripe.com/payment-links.md)
- [Página alojada en Stripe](https://docs.stripe.com/checkout/quickstart.md)
- [Integración avanzada](https://docs.stripe.com/payments/quickstart-checkout-sessions.md)


# .NET

> This is a .NET for when lang is dotnet. View the full page at https://docs.stripe.com/get-started/development-environment?lang=dotnet.

En este QuickStart, instala [la CLI de Stripe](https://docs.stripe.com/stripe-cli.md), una herramienta esencial que te proporciona acceso a la línea de comandos para tu integración de Stripe. También instalarás el [Stripe .NET server-side SDK](https://github.com/stripe/stripe-dotnet) para obtener acceso a las API de Stripe desde solicitudes escritas en C#.

## Lo que aprendes

En este inicio rápido, aprenderás a:

- Cómo llamar a las API de Stripe sin escribir una línea de código
- Cómo administrar dependencias de terceros mediante el uso de la interfaz de línea de comandos (CLI) de .NET Core, la CLI de NuGet o la Consola del administrador de paquetes
- Cómo instalar la versión más reciente Stripe .NET SDK v50.4.0
- Cómo enviar tu primera solicitud de SDK

## Configuración inicial

Primero, [crea una cuenta de Stripe](https://dashboard.stripe.com/register) o [inicia sesión](https://dashboard.stripe.com/login).

## Configurar la CLI de Stripe

### Instalar

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. Luego, instala la CLI.

#### homebrew

Para instalar la CLI de Stripe con [homebrew](https://brew.sh/), ejecuta el siguiente comando:

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

Este comando falla si lo ejecutas en la versión de Linux de homebrew, pero puedes usar esta alternativa o seguir las instrucciones de la pestaña Linux.

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

#### apt

> La compilación Debian para la CLI está disponible en JFrog en https://packages.stripe.dev, que no es un dominio de la propiedad de Stripe. Cuando visites esta URL, te redirigirá a la lista de artefactos de Jfrog.

Para instalar la CLI de Stripe en distribuciones basadas en Ubuntu y en Debian:

1. Add Stripe CLI’s GPG key to the apt sources keyring:

```bash
curl -s https://packages.stripe.dev/api/security/keypair/stripe-cli-gpg/public | gpg --dearmor | sudo tee /usr/share/keyrings/stripe.gpg
```

1. Agrega 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 compilación RPM para la CLI está disponible en JFrog en https://packages.stripe.dev, que no es un dominio de la propiedad de Stripe. Cuando visites esta URL, te redirigirá a la lista de artefactos de Jfrog.

Para instalar la CLI de Stripe en distribuciones basadas en RPM:

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 el siguiente comando:

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

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

Otra opción es 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:

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. Agrega la ruta que lleva al archivo `stripe.exe` descomprimido 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).

> De vez en cuando, los detectores antivirus de Windows marcan la CLI de Stripe como no segura. Es probable que se trate de un falso positivo. Para obtener más información, consulta [problema n.º 692](https://github.com/stripe/stripe-cli/issues/692) en el repositorio de GitHub.

1. Ejecuta el archivo `.exe` descomprimido.

#### 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 el siguiente comando:

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

### Autenticar

Inicie sesión y autentique tu [cuenta](https://docs.stripe.com/get-started/account/activate.md) de usuario de Stripe para generar un conjunto de claves restringidas. Para obtener más información, consulte [Claves y permisos de la CLI de Stripe](https://docs.stripe.com/stripe-cli/keys.md).

```bash
  stripe login
```

Presiona la tecla **Enter** en tu teclado para completar el proceso de autenticación en tu 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)
```

### Confirmar configuración

Ahora que has instalado la CLI, puedes realizar una sola solicitud de API para [Crear un producto](https://docs.stripe.com/api/products/create.md).

#### bash

```bash
stripe products create \
--name="My First Product" \
--description="Created with the Stripe CLI"
```

Busca el identificador del producto (en `id`) en el objeto de respuesta. Guárdalo para el próximo paso.

Si todo funcionó, la línea de comandos muestra la siguiente respuesta.

#### bash

```json
{
  "id": "prod_LTenIrmp8Q67sa", // El identificador se ve de esta manera.
  "object": "product",
  "active": true,
  "attributes": [],
  "created": 1668198126,
  "default_price": null,
  "description": "Created with the Stripe CLI",
  "identifiers": {},
  "images": [],
  "livemode": false,
  "metadata": {},
  "name": "My First Product",
  "package_dimensions": null,
  "price": null,
  "product_class": null,
  "shippable": null,
  "sku": "my-first-product-10",
  "statement_descriptor": null,
  "tax_code": null,
  "type": "service",
  "unit_label": null,
  "updated": 1668198126,
  "url": null
}
```

Luego, llama a [Crear un precio](https://docs.stripe.com/api/prices/create.md) para adjuntar un precio de USD&nbsp;30. Intercambia el marcador de posición en `product` con el identificador del producto (por ejemplo, `prod_LTenIrmp8Q67sa`).

#### bash

```bash
stripe prices create \
  --unit-amount=3000 \
  --currency=usd \
  --product="{{PRODUCT_ID}}"
```

Si todo funcionó, la línea de comandos muestra la siguiente respuesta.

#### bash

```json
{
  "id": "price_1KzlAMJJDeE9fu01WMJJr79o", // El identificador se ve de esta manera.
  "object": "price",
  "active": true,
  "billing_scheme": "per_unit",
  "created": 1652636348,
  "currency": "usd",
  "livemode": false,
  "lookup_key": null,
  "metadata": {},
  "nickname": null,
  "product": "prod_Lh9iTGZhb2mcBy",
  "recurring": null,
  "tax_behavior": "unspecified",
  "tiers_mode": null,
  "transform_quantity": null,
  "type": "one_time",
  "unit_amount": 3000,
  "unit_amount_decimal": "3000"
}
```

## Instalar el SDK del lado del servidor .NET

La última versión del SDK del lado del servidor de .NET de Stripe es v50.4.0. Admite .NET Standard 2.0+, .NET Core 2.0+, y .NET Framework 4.6.1+.

Revisa la versión del [SDK .NET](https://docs.microsoft.com/en-us/dotnet/core/install/how-to-detect-installed-versions):

```bash
dotnet --list-sdks
```

### Instala la biblioteca

Usa la [interfaz de línea de comandos (CLI) de .NET Core](https://docs.microsoft.com/en-us/dotnet/core/tools/) para crear un nuevo proyecto desde la línea de comandos:

```bash
dotnet new console
```

Para instalar la biblioteca, ejecuta este comando para agregar la referencia del paquete al archivo de proyecto (`.csproj`):

```bash
dotnet add package Stripe.net
```

Después de instalar la biblioteca con la interfaz de línea de comandos (CLI), la biblioteca se agrega automáticamente como una dependencia en el archivo del proyecto (`.csproj`). Por ejemplo:

```xml
<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net6.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Stripe.net" Version="50.4.0" />
  </ItemGroup>

</Project>
```

### Alternativas de instalación

**Interfaz de línea de comandos (CLI) de NuGet**—Puedes usar la [CLI de NuGet](https://docs.microsoft.com/en-us/nuget/tools/nuget-exe-cli-reference) para instalar la biblioteca:

```bash
nuget install Stripe.net
```

**Consola de Package Manager (PowerShell)**—Si estás usando la [Consola de Package Manager (PowerShell)](https://docs.microsoft.com/en-us/nuget/tools/package-manager-console), ejecuta el siguiente comando para instalar la biblioteca:

```PowerShell
Install-Package Stripe.net
```

**VisualStudio**—Para agregar el paquete Stripe.net a Visual Studio: Abre el Explorador de soluciones. Haz clic con el botón derecho en tu proyecto. Haz clic en **Administrar paquetes NuGet**. Haz clic en la pestaña **Explorar** y busca **Stripe.net**. Haz clic en el paquete **Stripe.net**, selecciona la versión adecuada en la pestaña y haz clic en **Instalar**.

## Ejecuta tu primera solicitud de SDK

Ahora que tienes instalado el SDK de .NET, puedes crear un [producto](https://docs.stripe.com/api/products/create.md) de suscripción y adjuntar un [precio](https://docs.stripe.com/api/prices/create.md) con un par de solicitudes de la API. En este ejemplo, usamos el identificador del producto devuelto en la respuesta para crear el precio.

> En este ejemplo, se usan las claves predeterminadas de tu [cuenta](https://docs.stripe.com/get-started/account/activate.md) de usuario de Stripe para tu *entorno de prueba* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes). Solo tú puedes ver estos valores.

#### Crear un producto y un precio

```dotnet
using System;
using Stripe;

class Program
{
  static void Main(string[] args)
  {
    var client = new StripeClient("sk_test_BQokikJOvBiI2HlWgH4olfQ2");

    var optionsProduct = new ProductCreateOptions
    {
      Name = "Starter Subscription",
      Description = "$12/Month subscription",
    };
    Product product = client.V1.Products.Create(optionsProduct);
    Console.Write("Success! Here is your starter subscription product id: {0}\n", product.Id);

    var optionsPrice = new PriceCreateOptions
    {
      UnitAmount = 1200,
      Currency = "usd",
      Recurring = new PriceRecurringOptions
      {
          Interval = "month",
      },
      Product = product.Id
    };
    Price price = client.V1.Prices.Create(optionsPrice);
    Console.Write("Success! Here is your starter subscription price id: {0}\n", price.Id);
  }
}
```

Guarda el código en el archivo `Program.cs` de tu proyecto. Desde la línea de comandos, `cd` al directorio que contiene el archivo que acabas de guardar y ejecuta:

#### Program.cs

```bash
dotnet run
```

Si todo funcionó, la línea de comandos muestra la siguiente respuesta. Guarda estos identificadores para poder usarlos mientras creas tu integración.

#### bash

```bash
Success! Here is your starter subscription product id: prod_0KxBDl589O8KAxCG1alJgiA6
Success! Here is your starter subscription price id: price_0KxBDm589O8KAxCGMgG7scjb
```

## See also

Esto concluye el inicio rápido. Consulta los siguientes enlaces para conocer algunas formas diferentes de procesar un pago para el producto que acabas de crear.

- [Crea un enlace de pago](https://docs.stripe.com/payment-links.md)
- [Página alojada en Stripe](https://docs.stripe.com/checkout/quickstart.md)
- [Integración avanzada](https://docs.stripe.com/payments/quickstart-checkout-sessions.md)