# Verwenden Sie die Stripe CLI

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

Weitere Informationen finden Sie im [Referenzdokument für das Stripe CLI](https://docs.stripe.com/cli.md).

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](https://docs.stripe.com/workbench/guides.md#view-api-versions) können. Verwenden Sie die folgenden Kennzeichnungen, um verschiedene API-Versionen in der CLI auszuprobieren:

| Flag                                 | Beschreibung                                                                                              | Beispiel                                                                          |
| ------------------------------------ | --------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| `--stripe-version 2026-03-25.dahlia` | Verwenden Sie die Flag `--stripe-version` in einer beliebigen CLI-Anfrage, um eine API-Version anzugeben. | `stripe products create --name=„Mein Produkt“ --Stripe-Version 2026-03-25.dahlia` |
| `--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](https://docs.stripe.com/upgrades.md#api-versions).

## Informationen zu Befehlsoptionen

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

```bash
   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.

```bash
  stripe logs tail
```

## Ereignisse an Ihren lokalen Webhook-Endpoint weiterleiten

Use the `--forward-to` flag to send all [Stripe events](https://docs.stripe.com/cli/trigger#trigger-event) in a **sandbox** to your local webhook endpoint. To disable HTTPS certificate verification, use the `--skip-verify` flag.

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

```bash
  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.

```bash
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](https://docs.stripe.com/webhooks.md#register-webhook), können Sie die Flags `--load-from-webhooks-api` und `--forward-to` verwenden.

```bash
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“](https://docs.stripe.com/cli/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](https://docs.stripe.com/checkout/quickstart.md) für [Stripe Checkout](https://docs.stripe.com/payments/checkout.md) aufzulisten:

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

## Einmaliges Produkt und Preis erstellen

1. Stellen Sie eine einzige API Anfrage zum [Erstellen eines Produkts](https://docs.stripe.com/api/products/create.md).

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

1. 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:

   ```json
   {
     "id": "prod_LTenIrmp8Q67sa", // Die Kennung sieht wie folgt aus.
     "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. Rufen Sie [Erstellen Sie einen Preis](https://docs.stripe.com/api/prices/create.md) au, um einen Preis von 30 USD hinzuzufügen. Tauschen Sie den Platzhalter in `product` gegen Ihre Produktkennung (zum Beispiel `prod_LTenIrmp8Q67sa`).

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

1. Wenn alles funktioniert hat, wird in der Befehlszeile die folgende Antwort angezeigt:

   ```json
   {
     "id": "price_1KzlAMJJDeE9fu01WMJJr79o", // Die Kennung sieht wie folgt aus.
     "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"
   }
   ```

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

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

Ihr`stripe listen`-Terminal zeigt die folgende Ausgabe an:

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