Utiliza la CLI de Stripe

Diseña, prueba y gestiona tu integración con Stripe desde la línea de comandos.

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

Especificar una versión de la API al ejecutar las solicitudes

Cuando llamas a las API de Stripe en la CLI, se usa tu versión de API predeterminada en todas las solicitudes, esto lo puedes identificar en Workbench. Para probar diferentes versiones de API en la CLI, use los siguientes indicadores:

Indicador	Descripción	Ejemplo
`--stripe-version 2025-08-27.basil`	Usa el indicador `--stripe-version` para realizar cualquier solicitud de CLI para especificar una versión de API.	`stripe products create --name=“My Product” --stripe-version 2025-08-27.basil`
`--latest`	Usa el indicador `--latest` para realizar cualquier solicitud de CLI para especificar la última versión de la API.	`stripe products create --name="My Product" --latest`

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

Transmitir registros de solicitudes

Usa el comando stripe logs tail para transmitir los registros de solicitudes de API. Mantén esta ventana abierta. Si se produce un error en las llamadas a la API, este terminal devuelve el mensaje de error de la API y muestra el motivo del error.

Command Line
stripe logs tail

Reenviar los eventos al punto de conexión de tu webhook local

Usa el indicador --forward-to para enviar todos los eventos de Stripe en un entorno de prueba al punto de conexión de tu webhook local. Para deshabilitar la verificación de certificados HTTPS, usa 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, usa 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 usar 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 en tu punto de conexión de webhook público registrado por Stripe al punto de conexión de tu webhook local. Además, carga tu punto de conexión registrado y analiza su ruta y los eventos registrados. Finalmente, añade la ruta al punto de conexión de tu webhook local en la ruta --forward-to. Si estás comprobando firmas de webhook, usa {{WEBHOOK_SIGNING_SECRET}} de los resultados iniciales del comando listen.

Enumera todos los eventos disponibles

Usa el indicador de ayuda (--help) para enumerar todos los eventos posibles que pueden producirse para una categoría de evento. Por ejemplo, para enumerar todos los eventos posibles para lapágina del proceso de compra prediseñada paraStripe Checkout:

Command Line
stripe trigger checkout --help

Crear un producto y un precio únicos

Hacer una sola solicitud a la API paraCrear 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 ido bien, la línea de comandos muestra la siguiente respuesta:
```
{
  "id": "prod_LTenIrmp8Q67sa",
  "object": "product",
```
Pulsa Crear un precio para adjuntar un precio de 30 USD. Intercambia el marcador de posición enproducto con tu identificador de 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 de webhook durante las pruebas

Activa el checkout.session.completed para crear los objetos API que resultan de una sesión de proceso de compra que se completa correctamente.

Command Line
stripe trigger checkout.session.completed

Tu terminal de stripe listen muestra el siguiente resultado:

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!