Verwenden Sie die Stripe CLI

Erstellen, testen und verwalten Sie Ihre Stripe-Integration über die Befehlszeile.

Mit der Stripe-CLI können Sie Ihre Stripe-Integration über die Befehlszeile erstellen, testen und verwalten. Mit der CLI können Sie Stripe-Ressourcen erstellen und verwalten, Webhook Ereignisse auslösen, API-Anfrage-Logs in Echtzeit streamen und Ereignisse an Ihre lokale Entwicklungsumgebung weiterleiten.

API-Version beim Ausführen von Anfragen angeben

Wenn Sie Stripe-APIs in der CLI aufrufen, wird Ihre Standard-API-Version in allen Anfragen verwendet, die Sie im Workbench ermitteln können. Verwenden Sie die folgenden Kennzeichnungen, um verschiedene API-Versionen in der CLI auszuprobieren:

Flag	Beschreibung	Beispiel
`--stripe-version 2025-12-15.clover`	Verwenden Sie die Flag `--stripe-version` in einer beliebigen CLI-Anfrage, um eine API-Version anzugeben.	`stripe products create --name=„Mein Produkt“ --Stripe-Version 2025-12-15.clover`
`--latest`	Verwenden Sie die Flag `--latest` in einer beliebigen CLI-Anfrage, um die neueste API-Version anzugeben.	`stripe products create --name="My Product" --latest`

Sie können auch eine Liste der API Versionen anzeigen.

Informationen zu Befehlsoptionen

Um mehr über Optionen für bestimmte Befehle zu erfahren, fügen Sie dem Befehl --help hinzu.

Command Line
stripe listen --help

Anfrage-Logs streamen

Verwenden Sie den Befehl `stripe logs tail``, um API-Anfrageprotokolle zu streamen. Lassen Sie dieses Fenster geöffnet. Wenn in Ihren API-Aufrufen ein Fehler vorhanden ist, gibt dieses Terminal die API-Fehlermeldung und einen Grund für den Fehler zurück.

Command Line
stripe logs tail

Ereignisse an Ihren lokalen Webhook-Endpoint weiterleiten

Use the --forward-to flag to send all Stripe events in a sandbox to your local webhook endpoint. To disable HTTPS certificate verification, use the --skip-verify flag.

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

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

Verwenden Sie die Flag --events, um bestimmte Ereignisse in einer kommagetrennten Liste weiterzuleiten.

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

Falls Sie Ihren Endpoint bereits in Stripe registriert haben, können Sie die Flags --load-from-webhooks-api und --forward-to verwenden.

Command Line
stripe listen --load-from-webhooks-api --forward-to localhost:4242

Dieser Befehl leitet Ereignisse, die an Ihren bei Stripe registrierten öffentlichen Webhook Endpoint gesendet werden, an Ihren lokalen Webhook Endpoint weiter. Er lädt Ihren registrierten Endpoint, analysiert den Pfad und seine registrierten Ereignisse und hängt dann den Pfad an Ihren lokalen Webhook Endpoint im Pfad --forward-to an. Wenn Sie Webhook Signaturen überprüfen, verwenden Sie den {{WEBHOOK_SIGNING_SECRET}} aus der Erstausgabe des Befehls listen.

Alle verfügbaren Ereignisse auflisten

Verwenden Sie die Flag „help“ (--help), um alle möglichen Ereignisse aufzulisten, die für eine Ereigniskategorie auftreten können. Zum Beispiel, um alle möglichen Ereignisse für die vorgefertigte Bezahlvorgangsseite für Stripe Checkout aufzulisten:

Command Line
stripe trigger checkout --help

Einmaliges Produkt und Preis erstellen

Stellen Sie eine einzige API Anfrage zum Erstellen eines Produkts.

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

Suchen Sie nach der Produktkennung (in id) im Antwortobjekt. Speichern Sie sie für den nächsten Schritt. Wenn alles funktioniert hat, zeigt die Befehlszeile die folgende Antwort an:
```
{
  "id": "prod_LTenIrmp8Q67sa",
  "object": "product",
```
Rufen Sie Erstellen Sie einen Preis au, um einen Preis von 30 USD hinzuzufügen. Tauschen Sie den Platzhalter in product gegen Ihre Produktkennung (zum Beispiel prod_LTenIrmp8Q67sa).
Command Line
```
stripe prices create \
  --unit-amount=3000 \
  --currency=usd \
  --product="{{PRODUCT_ID}}"
```
Wenn alles funktioniert hat, wird in der Befehlszeile die folgende Antwort angezeigt:
```
{
  "id": "price_1KzlAMJJDeE9fu01WMJJr79o",
  "object": "price",
```

Webhook-Ereignis beim Testen auslösen

Lösen Sie das Ereignis checkout.session.completed aus, um die API-Objekte zu erstellen, die auftreten, wenn eine Bezahlvorgangs-Sitzung erfolgreich abgeschlossen wird.

Command Line
stripe trigger checkout.session.completed

Ihrstripe listen-Terminal zeigt die folgende Ausgabe an:

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!