# Utiliza la CLI de Stripe Diseña, prueba y gestiona tu integración con Stripe desde la línea de comandos. Para obtener más información, consulta la [referencia de CLI de Stripe](https://docs.stripe.com/cli.md). 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](https://docs.stripe.com/workbench/guides.md#view-api-versions). Para probar diferentes versiones de API en la CLI, use los siguientes indicadores: | Indicador | Descripción | Ejemplo | | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------- | | `--stripe-version 2026-03-25.dahlia` | 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 2026-03-25.dahlia` | | `--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](https://docs.stripe.com/upgrades.md#api-versions). ## Más información sobre las opciones de comandos Para obtener más información sobre las opciones de comandos específicos, añade `ayuda` al comando. ```bash stripe listen --help ``` ## 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. ```bash 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](https://docs.stripe.com/cli/trigger#trigger-event) 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`. ```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, usa 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 usar 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 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](https://docs.stripe.com/cli/help) (`--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 la[página del proceso de compra prediseñada](https://docs.stripe.com/checkout/quickstart.md) para[Stripe Checkout](https://docs.stripe.com/payments/checkout.md): ```bash stripe trigger checkout --help ``` ## Crear un producto y un precio únicos 1. Hacer una sola solicitud a la API para[Crear 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 ido bien, 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. Pulsa [Crear un precio](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 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 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. ```bash stripe trigger checkout.session.completed ``` Tu terminal de `stripe listen` muestra el siguiente resultado: ```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! ```