# Configura tu entorno de desarrollo
Familiarízate con la CLI de Stripe y nuestros SDK del lado del servidor.
Echa un vistazo a 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 de Stripe y la interfaz de línea de comandos (CLI) te permiten interactuar con las API REST de Stripe. Empieza con la CLI de Stripe para optimizar tu entorno de desarrollo y hacer llamadas a la API.
Usa los SDK para evitar escribir código repetitivo. Para comenzar a enviar solicitudes desde tu entorno, elige un idioma para seguir 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 estén listos para completar una compra.
>
> Este método es más seguro y fácil de mantener que intentar 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 inicio rápido, instalarás la [CLI de Stripe](https://docs.stripe.com/stripe-cli.md), una herramienta esencial que te da acceso a la línea de comandos de tu integración con Stripe. También instalarás el [SDK del servidor Ruby de Stripe](https://github.com/stripe/stripe-ruby) para obtener acceso a las API de Stripe desde aplicaciones escritas en Ruby.
## Qué aprendes
Con este inicio rápido, aprenderás:
- Cómo llamar a las API de Stripe sin escribir una línea de código
- Cómo gestionar las dependencias de terceros mediante un bundler con RubyGems
- Cómo instalar el SDK de Stripe Ruby 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).
## Configura 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 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
```
Este comando falla si lo ejecutas en la versión Linux de homebrew, pero puedes usar esta alternativa o seguir las instrucciones en la pestaña Linux.
```bash
brew install stripe-cli
```
#### apt
> La Debian diseñada para la CLI está disponible en 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. 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. 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 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 de 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, 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. Añade `./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 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 probable que se trate de un falso positivo. Para obtener más información, consulta el [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 lo siguiente:
```bash
docker run --rm -it stripe/stripe-cli:latest
```
### Autenticar
Inicia sesión y autentica tu [cuenta](https://docs.stripe.com/get-started/account/activate.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
```
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)
```
### Confirma la configuración
Ahora que has instalado la CLI, puedes realizar una sola petición de API para [Create a product](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 ha funcionado, la línea de comandos muestra la siguiente respuesta.
#### bash
```json
{
"id": "prod_LTenIrmp8Q67sa", // El identificador se ve así.
"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
}
```
A continuación, pulsa [Create a price](https://docs.stripe.com/api/prices/create.md) para adjuntar un precio de 30 USD. Intercambia el marcador de posición en `product` con tu identificador de producto (por ejemplo, `prod_LTenIrmp8Q67sa`).
#### bash
```bash
stripe prices create \
--unit-amount=3000 \
--currency=usd \
--product="{{PRODUCT_ID}}"
```
Si todo ha funcionado, la línea de comandos muestra la siguiente respuesta.
#### bash
```json
{
"id": "price_1KzlAMJJDeE9fu01WMJJr79o", // El identificador se ve así.
"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 utilizando la herramienta de línea de comandos [RubyGems](http://rubygems.org/), que te permite añadir nuevas bibliotecas e incluirlas en tus proyectos de Ruby. Comprueba si RubyGems está instalado:
### Instala RubyGems
#### Instala RubyGems
```bash
gem --version
```
Si obtienes `gem: command not found`, [descarga RubyGems](http://rubygems.org/pages/download) desde su página de descargas.
## Instala el SDK del lado del servidor de Ruby
La última versión del SDK del servidor de Stripe Ruby es v18.4.0. Es compatible con las versiones de Ruby 2.3+.
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 el gem generado usando un bundler con [RubyGems](https://rubygems.org/).
Añade la última versión del [gem de Stripe](https://rubygems.org/gems/stripe) a un proyecto:
```bash
bundle add stripe
```
Instala los gems necesarios desde 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 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**: [compila el gem desde el origen](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 peticiones de API. Estamos usando el identificador del producto devuelto en la respuesta para crear el 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 *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.
#### Crea un producto y su 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 ejecútalo:
#### create_price.rb
```bash
ruby create_price.rb
```
Si todo ha funcionado, 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
Aquí finaliza la guía de inicio rápido. Consulta los siguientes enlaces para conocer algunas formas diferentes de procesar un pago por 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 inicio rápido, instalarás la [CLI de Stripe](https://docs.stripe.com/stripe-cli.md), una herramienta esencial que te da acceso a la línea de comandos de tu integración con Stripe. También instalarás el[SDK del servidor Python de Stripe](https://github.com/stripe/stripe-python) para obtener acceso a Stripe API desde aplicaciones escritas en Python.
## Qué aprendes
Con este inicio rápido, aprenderás:
- Cómo llamar a las API de Stripe sin escribir una línea de código
- Cómo administrar dependencias de terceros utilizando un entorno virtual y el gestor de paquetes de pip
- Cómo instalar el último SDK de Stripe Python 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).
## Configura 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 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
```
Este comando falla si lo ejecutas en la versión Linux de homebrew, pero puedes usar esta alternativa o seguir las instrucciones en la pestaña Linux.
```bash
brew install stripe-cli
```
#### apt
> La Debian diseñada para la CLI está disponible en 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. 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. 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 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 de 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, 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. Añade `./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 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 probable que se trate de un falso positivo. Para obtener más información, consulta el [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 lo siguiente:
```bash
docker run --rm -it stripe/stripe-cli:latest
```
### Autenticar
Inicia sesión y autentica tu [cuenta](https://docs.stripe.com/get-started/account/activate.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
```
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)
```
### Confirma la configuración
Ahora que has instalado la CLI, puedes realizar una sola petición de API para [Create a product](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 ha funcionado, la línea de comandos muestra la siguiente respuesta.
#### bash
```json
{
"id": "prod_LTenIrmp8Q67sa", // El identificador se ve así.
"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
}
```
A continuación, pulsa [Create a price](https://docs.stripe.com/api/prices/create.md) para adjuntar un precio de 30 USD. Intercambia el marcador de posición en `product` con tu identificador de producto (por ejemplo, `prod_LTenIrmp8Q67sa`).
#### bash
```bash
stripe prices create \
--unit-amount=3000 \
--currency=usd \
--product="{{PRODUCT_ID}}"
```
Si todo ha funcionado, la línea de comandos muestra la siguiente respuesta.
#### bash
```json
{
"id": "price_1KzlAMJJDeE9fu01WMJJr79o", // El identificador se ve así.
"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 mediante el módulo [venv](https://docs.python.org/3/tutorial/venv.html), 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
```
## Instala el SDK del lado del servidor de Python
La última versión del SDK del lado del servidor de Stripe Python es v14.4.0. Es compatible con la versión 3.6 de Python y posteriores.
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 peticiones a la API. Estamos usando el identificador del producto devuelto en la respuesta para crear el 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 *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.
#### Crea un producto y su 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 ejecútalo:
#### create_price.py
```bash
python3 create_price.py
```
Si todo ha funcionado, 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
Aquí finaliza la guía de inicio rápido. Consulta los siguientes enlaces para conocer algunas formas diferentes de procesar un pago por 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)
# Go
> This is a Go for when lang is go. View the full page at https://docs.stripe.com/get-started/development-environment?lang=go.
En este inicio rápido, instalarás la [CLI de Stripe](https://docs.stripe.com/stripe-cli.md), una herramienta esencial que te da acceso a la línea de comandos de tu integración con Stripe. También instalarás el[SDK del servidor Go de Stripe](https://github.com/stripe/stripe-go) para obtener acceso a las API de Stripe desde aplicaciones escritas en Go.
## Qué aprendes
Con este inicio rápido, aprenderás:
- Cómo llamar a las API de Stripe sin escribir una línea de código
- Cómo gestionar dependencias de terceros con los módulos Go
- Cómo instalar el último 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).
## Configura 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 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
```
Este comando falla si lo ejecutas en la versión Linux de homebrew, pero puedes usar esta alternativa o seguir las instrucciones en la pestaña Linux.
```bash
brew install stripe-cli
```
#### apt
> La Debian diseñada para la CLI está disponible en 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. 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. 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 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 de 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, 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. Añade `./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 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 probable que se trate de un falso positivo. Para obtener más información, consulta el [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 lo siguiente:
```bash
docker run --rm -it stripe/stripe-cli:latest
```
### Autenticar
Inicia sesión y autentica tu [cuenta](https://docs.stripe.com/get-started/account/activate.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
```
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)
```
### Confirma la configuración
Ahora que has instalado la CLI, puedes realizar una sola petición de API para [Create a product](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 ha funcionado, la línea de comandos muestra la siguiente respuesta.
#### bash
```json
{
"id": "prod_LTenIrmp8Q67sa", // El identificador se ve así.
"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
}
```
A continuación, pulsa [Create a price](https://docs.stripe.com/api/prices/create.md) para adjuntar un precio de 30 USD. Intercambia el marcador de posición en `product` con tu identificador de producto (por ejemplo, `prod_LTenIrmp8Q67sa`).
#### bash
```bash
stripe prices create \
--unit-amount=3000 \
--currency=usd \
--product="{{PRODUCT_ID}}"
```
Si todo ha funcionado, la línea de comandos muestra la siguiente respuesta.
#### bash
```json
{
"id": "price_1KzlAMJJDeE9fu01WMJJr79o", // El identificador se ve así.
"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 utilizando [módulos Go](https://go.dev/blog/using-go-modules), lo que te permite agregar nuevas bibliotecas e incluirlas en tus proyectos Go.
### Inicializa Go
Si empiezas de cero en un directorio nuevo, primero tienes que crear un archivo `go.mod` para rastrear las dependencias. Por ejemplo:
#### Inicializa Go
```bash
go mod init stripe-example
```
## Instala 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 gestor 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 a *new* project, 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 *existing* project, 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 peticiones a la API. Estamos usando el identificador del producto devuelto en la respuesta para crear el 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 *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.
#### Crea un producto y su 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 ejecútalo:
#### create_price.rb
```bash
go run create_price.go
```
Si todo ha funcionado, 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
Aquí finaliza la guía de inicio rápido. Consulta los siguientes enlaces para conocer algunas formas diferentes de procesar un pago por 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 inicio rápido, instalarás la [CLI de Stripe](https://docs.stripe.com/stripe-cli.md), una herramienta esencial que te da acceso a la línea de comandos de tu integración con Stripe. También instalarás el[SDK del servidor Java de Stripe](https://github.com/stripe/stripe-java) para obtener acceso a las API de Stripe desde aplicaciones escritas en Java.
## Qué aprendes
Con este inicio rápido, aprenderás:
- Cómo llamar a las API de Stripe sin escribir una línea de código
- Cómo gestionar las dependencias de terceros con 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).
## Configura 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 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
```
Este comando falla si lo ejecutas en la versión Linux de homebrew, pero puedes usar esta alternativa o seguir las instrucciones en la pestaña Linux.
```bash
brew install stripe-cli
```
#### apt
> La Debian diseñada para la CLI está disponible en 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. 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. 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 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 de 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, 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. Añade `./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 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 probable que se trate de un falso positivo. Para obtener más información, consulta el [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 lo siguiente:
```bash
docker run --rm -it stripe/stripe-cli:latest
```
### Autenticar
Inicia sesión y autentica tu [cuenta](https://docs.stripe.com/get-started/account/activate.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
```
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)
```
### Confirma la configuración
Ahora que has instalado la CLI, puedes realizar una sola petición de API para [Create a product](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 ha funcionado, la línea de comandos muestra la siguiente respuesta.
#### bash
```json
{
"id": "prod_LTenIrmp8Q67sa", // El identificador se ve así.
"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
}
```
A continuación, pulsa [Create a price](https://docs.stripe.com/api/prices/create.md) para adjuntar un precio de 30 USD. Intercambia el marcador de posición en `product` con tu identificador de producto (por ejemplo, `prod_LTenIrmp8Q67sa`).
#### bash
```bash
stripe prices create \
--unit-amount=3000 \
--currency=usd \
--product="{{PRODUCT_ID}}"
```
Si todo ha funcionado, la línea de comandos muestra la siguiente respuesta.
#### bash
```json
{
"id": "price_1KzlAMJJDeE9fu01WMJJr79o", // El identificador se ve así.
"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 gestionar 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 añadir nuevas bibliotecas e incluirlas en tus proyectos de Java.
### Inicializar un proyecto
- Para crear un proyecto con **Maven**, consulta [¿Cómo puedo crear mi primer proyecto 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 [Ejemplo de creación de aplicaciones Java](https://docs.gradle.org/current/samples/sample_building_java_applications.html).
## Instala el SDK del lado del servidor de Java
La última versión del SDK del servidor de Java de Stripe es v31.4.0. Es compatible con las versiones de Java 1.8+.
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
com.stripe
stripe-java
31.4.0
```
- 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 JAR de Stripe (.jar)](https://search.maven.org/remote_content?g=com.stripe&a=stripe-java&v=LATEST).
[Descargar el JAR de Gson (.jar)](https://repo1.maven.org/maven2/com/google/code/gson/gson/2.8.9/gson-2.8.9.jar) para [Google Gson](https://github.com/google/gson).
**Proguard**: si estás usando ProGuard, asegúrate de excluir la biblioteca añadiendo 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 peticiones a la API. Estamos usando el identificador del producto devuelto en la respuesta para crear el 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 *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.
#### Crea un producto y su 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 ha funcionado, 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
Aquí finaliza la guía de inicio rápido. Consulta los siguientes enlaces para conocer algunas formas diferentes de procesar un pago por 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 inicio rápido, instalarás la [CLI de Stripe](https://docs.stripe.com/stripe-cli.md), una herramienta esencial que te da acceso a la línea de comandos de tu integración con Stripe. También instalarás el[SDK del servidor Node.js de Stripe](https://github.com/stripe/stripe-node) para obtener acceso a las API de Stripe desde aplicaciones escritas en Node.js.
## Qué aprendes
Con este inicio rápido, aprenderás:
- Cómo llamar a las API de Stripe sin escribir una línea de código
- Cómo gestionar dependencias de terceros utilizando el npm o el gestor de paquetes de 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).
## Configura 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 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
```
Este comando falla si lo ejecutas en la versión Linux de homebrew, pero puedes usar esta alternativa o seguir las instrucciones en la pestaña Linux.
```bash
brew install stripe-cli
```
#### apt
> La Debian diseñada para la CLI está disponible en 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. 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. 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 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 de 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, 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. Añade `./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 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 probable que se trate de un falso positivo. Para obtener más información, consulta el [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 lo siguiente:
```bash
docker run --rm -it stripe/stripe-cli:latest
```
### Autenticar
Inicia sesión y autentica tu [cuenta](https://docs.stripe.com/get-started/account/activate.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
```
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)
```
### Confirma la configuración
Ahora que has instalado la CLI, puedes realizar una sola petición de API para [Create a product](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 ha funcionado, la línea de comandos muestra la siguiente respuesta.
#### bash
```json
{
"id": "prod_LTenIrmp8Q67sa", // El identificador se ve así.
"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
}
```
A continuación, pulsa [Create a price](https://docs.stripe.com/api/prices/create.md) para adjuntar un precio de 30 USD. Intercambia el marcador de posición en `product` con tu identificador de producto (por ejemplo, `prod_LTenIrmp8Q67sa`).
#### bash
```bash
stripe prices create \
--unit-amount=3000 \
--currency=usd \
--product="{{PRODUCT_ID}}"
```
Si todo ha funcionado, la línea de comandos muestra la siguiente respuesta.
#### bash
```json
{
"id": "price_1KzlAMJJDeE9fu01WMJJr79o", // El identificador se ve así.
"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"
}
```
## Instala 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 gestor 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 [Yarnpkg](https://yarnpkg.com/), otro gestor de paquetes para Nodo:
```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 peticiones a 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, pasamos 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 *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.
#### Crea un producto y su 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 ejecútalo:
#### create_price.js
```bash
node create_price.js
```
Si todo ha funcionado, 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
Aquí finaliza la guía de inicio rápido. Consulta los siguientes enlaces para conocer algunas formas diferentes de procesar un pago por 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 inicio rápido, instalarás la [CLI de Stripe](https://docs.stripe.com/stripe-cli.md), una herramienta esencial que te da acceso a la línea de comandos de tu integración con Stripe. También instalarás el[SDK del servidor PHP de Stripe](https://github.com/stripe/stripe-php) para obtener acceso a las API de Stripe desde aplicaciones escritas en PHP.
## Qué aprendes
Con este inicio rápido, aprenderás:
- Cómo llamar a las API de Stripe sin escribir una línea de código
- Cómo gestionar dependencias de terceros con Composer
- Cómo instalar el último SDK de Stripe PHP 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).
## Configura 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 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
```
Este comando falla si lo ejecutas en la versión Linux de homebrew, pero puedes usar esta alternativa o seguir las instrucciones en la pestaña Linux.
```bash
brew install stripe-cli
```
#### apt
> La Debian diseñada para la CLI está disponible en 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. 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. 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 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 de 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, 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. Añade `./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 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 probable que se trate de un falso positivo. Para obtener más información, consulta el [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 lo siguiente:
```bash
docker run --rm -it stripe/stripe-cli:latest
```
### Autenticar
Inicia sesión y autentica tu [cuenta](https://docs.stripe.com/get-started/account/activate.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
```
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)
```
### Confirma la configuración
Ahora que has instalado la CLI, puedes realizar una sola petición de API para [Create a product](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 ha funcionado, la línea de comandos muestra la siguiente respuesta.
#### bash
```json
{
"id": "prod_LTenIrmp8Q67sa", // El identificador se ve así.
"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
}
```
A continuación, pulsa [Create a price](https://docs.stripe.com/api/prices/create.md) para adjuntar un precio de 30 USD. Intercambia el marcador de posición en `product` con tu identificador de producto (por ejemplo, `prod_LTenIrmp8Q67sa`).
#### bash
```bash
stripe prices create \
--unit-amount=3000 \
--currency=usd \
--product="{{PRODUCT_ID}}"
```
Si todo ha funcionado, la línea de comandos muestra la siguiente respuesta.
#### bash
```json
{
"id": "price_1KzlAMJJDeE9fu01WMJJr79o", // El identificador se ve así.
"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 desde [Packagist](https://packagist.org/) utilizando [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, [descarga Composer](https://getcomposer.org/download/) siguiendo las instrucciones.
## Instala el SDK del lado del servidor PHP
La última versión del SDK del servidor de Stripe PHP es v19.4.0. Es compatible con las versiones de PHP 5.6.0+.
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 añade 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, use [autocargar](https://getcomposer.org/doc/01-basic-usage.md#autoloading) de Composer. 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, añade las siguientes extensiones: [cURL](https://secure.php.net/manual/en/book.curl.php) (como alternativa, puedes usar tu propio cliente que no sea de 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 API. Estamos usando el identificador del producto devuelto en la respuesta para crear el 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 *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.
#### Crea un producto y su precio
```php
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";
?>
```
Guarda el archivo como `create_price.php`. Desde la línea de comandos, `cd` al directorio que contiene el archivo que acabas de guardar y ejecútalo:
#### create_price.php
```bash
php create_price.php
```
Si todo ha funcionado, 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
Aquí finaliza la guía de inicio rápido. Consulta los siguientes enlaces para conocer algunas formas diferentes de procesar un pago por 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 inicio rápido, instalarás la [CLI de Stripe](https://docs.stripe.com/stripe-cli.md), una herramienta esencial que te da acceso a la línea de comandos de tu integración con Stripe. También instalarás el[SDK del servidor .NET de Stripe](https://github.com/stripe/stripe-dotnet) para obtener acceso a las API de Stripe desde aplicaciones escritas en C#.
## Qué aprendes
Con este inicio rápido, aprenderás:
- Cómo llamar a las API de Stripe sin escribir una línea de código
- Cómo administrar dependencias de terceros mediante la .NET Core CLI, NuGet CLI o la Consola de administración de paquetes
- Cómo instalar el último SDK de Stripe .NET 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).
## Configura 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 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
```
Este comando falla si lo ejecutas en la versión Linux de homebrew, pero puedes usar esta alternativa o seguir las instrucciones en la pestaña Linux.
```bash
brew install stripe-cli
```
#### apt
> La Debian diseñada para la CLI está disponible en 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. 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. 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 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 de 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, 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. Añade `./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 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 probable que se trate de un falso positivo. Para obtener más información, consulta el [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 lo siguiente:
```bash
docker run --rm -it stripe/stripe-cli:latest
```
### Autenticar
Inicia sesión y autentica tu [cuenta](https://docs.stripe.com/get-started/account/activate.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
```
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)
```
### Confirma la configuración
Ahora que has instalado la CLI, puedes realizar una sola petición de API para [Create a product](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 ha funcionado, la línea de comandos muestra la siguiente respuesta.
#### bash
```json
{
"id": "prod_LTenIrmp8Q67sa", // El identificador se ve así.
"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
}
```
A continuación, pulsa [Create a price](https://docs.stripe.com/api/prices/create.md) para adjuntar un precio de 30 USD. Intercambia el marcador de posición en `product` con tu identificador de producto (por ejemplo, `prod_LTenIrmp8Q67sa`).
#### bash
```bash
stripe prices create \
--unit-amount=3000 \
--currency=usd \
--product="{{PRODUCT_ID}}"
```
Si todo ha funcionado, la línea de comandos muestra la siguiente respuesta.
#### bash
```json
{
"id": "price_1KzlAMJJDeE9fu01WMJJr79o", // El identificador se ve así.
"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"
}
```
## Instala el SDK del lado del servidor .NET
La última versión del SDK del servidor de Stripe .NET es v50.4.0. Es compatible con .NET Standard 2.0+, .NET Core 2.0+ y .NET Framework 4.6.1+.
Comprueba las versiones del [.NET SDK](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) del núcleo .NET](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 CLI, la biblioteca se agrega automáticamente como una dependencia en el archivo de proyecto (`.csproj`). Por ejemplo:
```xml
Exe
net6.0
enable
enable
```
### 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 del gestor de paquetes (PowerShell)**: si estás usando la [consola del gestor de paquetes (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 añadir el paquete Stripe.net a Visual Studio, abre el Explorador de soluciones. Después, haz clic con el botón derecho en tu proyecto. Haz clic en **Administrar paquetes NuGet** y luego en la pestaña **Examinar** 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 API. Estamos usando el identificador del producto devuelto en la respuesta para crear el 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 *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.
#### Crea un producto y su 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 ejecútalo:
#### Program.cs
```bash
dotnet run
```
Si todo ha funcionado, 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
Aquí finaliza la guía de inicio rápido. Consulta los siguientes enlaces para conocer algunas formas diferentes de procesar un pago por 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)