# Utiliza la CLI de Stripe

Construye, prueba y gestiona tu integración de Stripe desde la línea de comandos.

Para obtener más información, consulta la [referencia de la CLI de Stripe](https://docs.stripe.com/cli.md).

La CLI de Stripe te permite crear, probar y gestionar tu integración de Stripe desde la línea de comandos. Con la CLI, puedes crear y gestionar recursos Stripe, desencadenar eventos webhook, transmitir registros de solicitudes API en tiempo real y reenviar eventos a tu entorno de desarrollo local.

## Especificar una versión de API al ejecutar solicitudes

Cuando llamas a las API de CLI de Stripe, esta utiliza su versión de API predeterminada en todas las solicitudes, que puede [identificar en Workbench](https://docs.stripe.com/workbench/guides.md#view-api-versions). Para probar diferentes versiones de API en la CLI, utiliza los siguientes indicadores:

| Indicador                            | Descripción                                                                                                | Ejemplo                                                                          |
| ------------------------------------ | ---------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
| `--stripe-version 2026-03-25.dahlia` | Utiliza el indicador `--stripe-version` en cualquier solicitud CLI para especificar una versión de la API. | `stripe products create --name=“Mi producto” --stripe-version 2026-03-25.dahlia` |
| `--latest`                           | Utiliza el indicador `--latest` en cualquier solicitud CLI para especificar la última versión de la API.   | `stripe products create --name="My Product" --latest`                            |

También puedes [ver una lista de las versiones de la API](https://docs.stripe.com/upgrades.md#api-versions).

## Obtén más información sobre las opciones de comandos

Para obtener más información sobre las opciones de comandos específicos, agrega `ayuda` al comando.

```bash
   stripe listen --help
```

## Registros de solicitudes de flujos

Utiliza el comando `stripe logs tail` para transmitir los registros de solicitudes de la API. Mantén esta ventana abierta. Si se produce un error en tus llamadas API, esta terminal te devuelve el mensaje de error de la API y un motivo del error.

```bash
  stripe logs tail
```

## Reenvía los eventos a tu punto de conexión webhook local

Utiliza el indicador `--forward-to` para enviar todos los [eventos de Stripe](https://docs.stripe.com/cli/trigger#trigger-event) en un **entorno de prueba** a tu punto de conexión webhook local. Para desactivar la verificación de certificados HTTPS, utiliza el indicador `--skip-verify`.

```bash
  stripe listen --forward-to localhost:4242/webhooks
```

```bash
  Ready! Your webhook signing secret is '{{WEBHOOK_SIGNING_SECRET}}' (^C to quit)
```

Para reenviar eventos específicos en una lista separada por comas, utiliza el indicador `--events`.

```bash
stripe listen --events payment_intent.created,customer.created,payment_intent.succeeded,charge.succeeded,checkout.session.completed,charge.failed \
  --forward-to localhost:4242/webhook
```

Si ya has [registrado tu punto de conexión en Stripe](https://docs.stripe.com/webhooks.md#register-webhook), puedes utilizar los indicadores `--load-from-webhooks-api` y `--forward-to`.

```bash
stripe listen --load-from-webhooks-api --forward-to localhost:4242
```

Este comando reenvía los eventos enviados a tu punto final de webhook **público** registrado en Stripe a tu punto final de webhook **local**. Carga tu punto final registrado, analiza la ruta y sus eventos registrados y, a continuación, añade la ruta a tu punto final de webhook local en la ruta `--forward-to`. Si estás comprobando firmas de webhook, utiliza el comando `{{WEBHOOK_SIGNING_SECRET}}` de la salida inicial del comando `listen`.

## Listar todos los eventos disponibles

Utiliza el [indicador de ayuda](https://docs.stripe.com/cli/help) (`--help`) para listar todos los posibles eventos que pueden ocurrir para una categoría de evento. Por ejemplo, para listar todos los posibles eventos para la [página de proceso de compra pre-construida](https://docs.stripe.com/checkout/quickstart.md) para [Stripe Checkout](https://docs.stripe.com/payments/checkout.md):

```bash
  stripe trigger checkout --help
```

## Crea un producto y un precio únicos

1. Realiza una única solicitud de API a [Crea un producto](https://docs.stripe.com/api/products/create.md).

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

1. Busca el identificador del producto (en `id`) en el objeto de respuesta. Guárdalo para el siguiente paso. Si todo ha funcionado, la línea de comandos muestra la siguiente respuesta:

   ```json
   {
     "id": "prod_LTenIrmp8Q67sa", // El identificador tiene este aspecto.
     "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
   }
   ```

1. Llama a [Crear un precio](https://docs.stripe.com/api/prices/create.md) para adjuntar un precio de USD 30. Cambia el marcador de posición de `product` por el identificador de su producto (por ejemplo, `prod_LTenIrmp8Q67sa`).

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

1. Si todo ha funcionado, la línea de comandos muestra la siguiente respuesta:

   ```json
   {
     "id": "price_1KzlAMJJDeE9fu01WMJJr79o", // El identificador tiene este aspecto.
     "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"
   }
   ```

## Activar un evento webhook durante la prueba

Acciona el evento `checkout.session.completed` para crear los objetos API resultantes de la finalización con éxito de una sesión de confirmación de compra.

```bash
stripe trigger checkout.session.completed
```

Tu terminal `stripe listen` muestra la siguiente salida:

```bash
Setting up fixture for: checkout_session
Running fixture for: checkout_session
Setting up fixture for: payment_page
Running fixture for: payment_page
Setting up fixture for: payment_method
Running fixture for: payment_method
Setting up fixture for: payment_page_confirm
Running fixture for: payment_page_confirm
Trigger succeeded!
```