Utilizza la CLI di Stripe

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

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 . Per provare diverse versioni API nella CLI, utilizza i seguenti flag:

Flag	Descrizione	Esempio
`--stripe-version 2025-08-27.basil`	Utilizza il flag `--stripe-version` in tutte le richieste CLI per specificare una versione API.	`stripe products create --name=“My Product” --stripe-version 2025-08-27.basil`
`--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.

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.

Command Line
stripe logs tail

Inoltra gli eventi al tuo endpoint webhook locale

Utilizza il flag --forward-to per inviare tutti gli eventi Stripe in una sandbox al tuo endpoint webhook locale. Per disabilitare la verifica del certificato HTTPS, utilizza il flag --skip-verify.

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

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

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

Se hai già registrato il tuo endpoint in Stripe, puoi usare i flag --load-from-webhooks-api e--forward-to.

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

Command Line
stripe trigger checkout --help

Crea un prodotto e un prezzo una tantum

Effettuare una singola richiesta API per crea un prodotto.

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

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:
```
{
  "id": "prod_LTenIrmp8Q67sa",
  "object": "product",
```
Vai su Crea un prezzo per allegare la tariffa di 30 USD. Scambia l’elemento segnaposto in product con il tuo identificatore di prodotto (ad esempio,prod_LTenIrmp8Q67sa).
Command Line
```
stripe prices create \
  --unit-amount=3000 \
  --currency=usd \
  --product={{PRODUCT_ID}}
```
Se tutto ha funzionato, la riga di comando mostra la seguente risposta:
```
{
  "id": "price_1KzlAMJJDeE9fu01WMJJr79o",
  "object": "price",
```

Attiva un evento webhook durante il test

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

Command Line
stripe trigger checkout.session.completed

Il terminale stripe listen mostra il seguente output:

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!