# Utilizza la CLI di Stripe

Crea, testa e gestisci la tua integrazione Stripe dalla riga di comando.

Per ulteriori dettagli, consulta la [documentazione di riferimento della CLI di Stripe](https://docs.stripe.com/cli.md).

La CLI Stripe ti consente di creare, testare e gestire la tua integrazione Stripe dalla riga di comando. Con la CLI puoi creare e gestire risorse Stripe, attivare eventi webhook, trasmettere in streaming i log delle richieste API in tempo reale e inoltrare gli eventi al tuo ambiente di sviluppo locale.

## Specifica una versione dell’API durante l’esecuzione delle richieste

Quando chiami le API Stripe nella CLI, questa utilizza la versione API predefinita in tutte le richieste, che puoi [identificare in Workbench ](https://docs.stripe.com/workbench/guides.md#view-api-versions). Per provare diverse versioni API nella CLI, utilizza i seguenti flag:

| Flag                                 | Descrizione                                                                                          | Esempio                                                                         |
| ------------------------------------ | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| `--stripe-version 2026-03-25.dahlia` | Utilizza il flag `--stripe-version` in tutte le richieste CLI per specificare una versione API.      | `stripe products create --name=“My Product” --stripe-version 2026-03-25.dahlia` |
| `--latest`                           | Utilizza il flag`--latest` in tutte le richieste CLI per specificare la versione API più aggiornata. | `stripe products create --name="My Product" --latest`                           |

Puoi anche [visualizzare un elenco delle versioni API](https://docs.stripe.com/upgrades.md#api-versions).

## Scopri le opzioni dei comandi

Per conoscere le opzioni di un comando specifico, aggiungi `--help` al comando.

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

## Streaming del log di richieste

Utilizza il comando `stripe logs tail` per trasmettere in streaming i log delle richieste API. Tieni aperta questa finestra. Se si verifica un errore nelle chiamate API, questo terminale restituisce il messaggio di errore API e il motivo dell’errore.

```bash
  stripe logs tail
```

## Inoltra gli eventi al tuo endpoint webhook locale

Utilizza il flag `--forward-to` per inviare tutti gli [eventi Stripe](https://docs.stripe.com/cli/trigger#trigger-event) in una **sandbox** al tuo endpoint webhook locale. Per disabilitare la verifica del certificato HTTPS, utilizza il flag `--skip-verify`.

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

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

Per inoltrare eventi specifici in un elenco separato da virgole, usa il flag `--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
```

Se hai già [registrato il tuo endpoint in Stripe](https://docs.stripe.com/webhooks.md#register-webhook), puoi usare i flag `--load-from-webhooks-api` e`--forward-to`.

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

Questo comando inoltra gli eventi inviati al tuo endpoint webhook **pubblico** registrato su Stripe al tuo endpoint webhook **locale**. Carica il tuo endpoint registrato, analizza il percorso e gli eventi registrati, quindi aggiunge il percorso al tuo endpoint webhook locale nel percorso `--forward-to`. Se stai controllando le firme dei webhook, utilizza `{{WEBHOOK_SIGNING_SECRET}}` dall’output iniziale del comando `listen`.

## Elenca tutti gli eventi disponibili

Utilizza il [flag di assistenza](https://docs.stripe.com/cli/help) (`--help`) per elencare tutti gli eventi possibili che possono verificarsi per una categoria di eventi. Ad esempio, per elencare tutti i possibili eventi per la [pagina completamento della transazione predefinita](https://docs.stripe.com/checkout/quickstart.md) per[Stripe Checkout](https://docs.stripe.com/payments/checkout.md):

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

## Crea un prodotto e un prezzo una tantum

1. Effettuare una singola richiesta API per [crea un prodotto](https://docs.stripe.com/api/products/create.md).

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

1. Individua l’identificatore del prodotto (in `id`) nell’oggetto di risposta. Salvalo per il passaggio successivo. Se tutto ha funzionato, la riga di comando mostra la seguente risposta:

   ```json
   {
     "id": "prod_LTenIrmp8Q67sa", // L'identificatore è simile al seguente.
     "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. Vai su [Crea un prezzo](https://docs.stripe.com/api/prices/create.md) per allegare la tariffa di 30 USD. Scambia l’elemento segnaposto in `product` con il tuo identificatore di prodotto (ad esempio,`prod_LTenIrmp8Q67sa`).

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

1. Se tutto ha funzionato, la riga di comando mostra la seguente risposta:

   ```json
   {
     "id": "price_1KzlAMJJDeE9fu01WMJJr79o", // L'identificatore è simile al seguente.
     "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"
   }
   ```

## Attiva un evento webhook durante il test

Attiva l’evento `checkout.session.completed`per creare gli oggetti API risultanti dal completamento corretto di una sessione di completamento della transazione.

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

Il terminale `stripe listen` mostra il seguente output:

```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!
```