Utiliza la CLI de Stripe

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

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. Para probar diferentes versiones de API en la CLI, utiliza los siguientes indicadores:

Indicador	Descripción	Ejemplo
`--stripe-version 2025-08-27.basil`	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 2025-08-27.basil`
`--latest`	Utiliza el indicador `--latest` en cualquier solicitud CLI para especificar la última versión de la API.	`stripe products create --name="Mi producto" --latest`

También puedes ver una lista de las versiones de la API.

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.

Command Line
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 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.

Command Line
stripe listen --forward-to localhost:4242/webhooks

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

Command Line
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, puedes utilizar los indicadores --load-from-webhooks-api y --forward-to.

Command Line
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 (--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 para Stripe Checkout:

Command Line
stripe trigger checkout --help

Crea un producto y un precio únicos

Realiza una única solicitud de API a Crea un producto.

Command Line
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 siguiente paso. Si todo ha funcionado, la línea de comandos muestra la siguiente respuesta:
```
{
  "id": "prod_LTenIrmp8Q67sa",
  "object": "product",
```
Llama a Crear un precio para adjuntar un precio de 30 USD. Cambie el marcador de posición del producto por el identificador de su producto (por ejemplo, prod_LTenIrmp8Q67sa).
Command Line
```
stripe prices create \
  --unit-amount=3000 \
  --currency=usd \
  --product={{PRODUCT_ID}}
```
Si todo ha funcionado, la línea de comandos muestra la siguiente respuesta:
```
{
  "id": "price_1KzlAMJJDeE9fu01WMJJr79o",
  "object": "price",
```

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.

Command Line
stripe trigger checkout.session.completed

Tu terminal stripe listen muestra la siguiente salida:

Command Line

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!