# Entwicklungsumgebung einrichten

Machen Sie sich mit der Stripe-CLI und unseren serverseitigen SDKs vertraut.

Lesen Sie unsere [No-Code-Dokumentation](https://docs.stripe.com/no-code.md), verwenden Sie eine [vorgefertigte Lösung](https://stripe.com/partners/directory) aus unserem Partnerverzeichnis oder engagieren Sie [von Stripe zertifizierte Expertinnen und Experten](https://stripe.com/partners/directory?t=Consulting).

Die serverseitigen SDKs und die Befehlszeilenschnittstelle (CLI) von Stripe ermöglichen die Interaktion mit den REST-APIs von Stripe. Beginnen Sie mit der Stripe-CLI, um Ihre Entwicklungsumgebung zu optimieren und API-Aufrufe durchzuführen.

Verwenden Sie die SDKs, um das Schreiben von Standardcode zu vermeiden. Um Anfragen aus Ihrer Umgebung zu senden, wählen Sie eine Sprache aus, um einen Quickstart-Leitfaden zu befolgen.

> #### Chrome-Erweiterungen
> 
> Wir empfehlen, Ihre Zahlungsintegration mit Stripe (wie [Elements](https://docs.stripe.com/payments/elements.md) oder [Checkout](https://docs.stripe.com/payments/checkout.md)) auf Ihrer eigenen Website zu erstellen. Richten Sie dann Ihre Chrome-Erweiterung so ein, dass Nutzer/innen an diese Zahlungsseite weitergeleitet werden, wenn sie bereit sind, einen Kauf abzuschließen.
> 
> Diese Methode ist sicherer und einfacher zu pflegen, als zu versuchen, Zahlungen direkt in der Erweiterung abzuwickeln.

# PHP


In diesem QuickStart installieren Sie die [Stripe-CLI](https://docs.stripe.com/stripe-cli.md), ein wichtiges Tool, über das Sie Befehlszeilenzugriff auf Ihre Stripe Integration erhalten. Außerdem installieren Sie das [serverseitige PHP-SDK von Stripe](https://github.com/stripe/stripe-php), um Zugriff auf Stripe-APIs über in PHP erstellte Anwendungen zu erhalten.

## Was Sie erfahren

In diesem Quickstart-Leitfaden erfahren Sie:

- Vorgehensweise zum Aufrufen von Stripe-APIs, ohne Code zu erstellen
- Vorgehensweise zur Verwaltung von Abhängigkeiten von Drittanbietern mithilfe von Composer
- Vorgehensweise zur Installation der aktuellen Version des PHP-SDK von Stripe20.2.0
- Vorgehensweise zum Senden Ihrer ersten SDK-Anfrage

## Ersteinrichtung

[Erstellen Sie zunächst ein Stripe-Konto](https://dashboard.stripe.com/register) oder [melden Sie sich an](https://dashboard.stripe.com/login).

## Stripe CLI einrichten

### Installieren

Geben Sie in der Befehlszeile ein Installationsskript an oder laden Sie eine versionierte Archivdatei für Ihr Betriebssystem herunter und extrahieren Sie diese, um die CLI zu installieren.

#### Homebrew

Führen Sie zur Installation der Stripe-CLI mit [Homebrew](https://brew.sh/) Folgendes aus:

```bash
brew install stripe/stripe-cli/stripe
```

Dieser Befehl schlägt fehl, wenn Sie ihn auf der Linux-Version von Homebrew ausführen, aber Sie können diese Alternative verwenden oder den Anweisungen auf der Registerkarte „Linux“ folgen.

```bash
brew install stripe-cli
```

#### apt

> Der Debian-Build für die CLI ist auf JFrog unter https://packages.stripe.dev, verfügbar. Bei dieser Domain handelt es sich nicht um eine Stripe-Domain. Wenn Sie diese URL besuchen, werden Sie zur Jfrog Artifactory-Liste weitergeleitet.

So installieren Sie die Stripe-CLI auf Debian- und Ubuntu-basierten Distributionen:

1. Fügen Sie den GPG-Schlüssel der Stripe-CLI zum Schlüsselbund der apt-Quellen hinzu:

```bash
curl -s https://packages.stripe.dev/api/security/keypair/stripe-cli-gpg/public | gpg --dearmor | sudo tee /usr/share/keyrings/stripe.gpg > /dev/null
```

1. Fügen Sie das apt-Repository der CLI zur Liste der apt-Quellen hinzu:

```bash
echo "deb [signed-by=/usr/share/keyrings/stripe.gpg] https://packages.stripe.dev/stripe-cli-debian-local stable main" | sudo tee -a /etc/apt/sources.list.d/stripe.list
```

1. Aktualisieren Sie die Paketliste:

```bash
sudo apt update
```

1. Installieren Sie die CLI:

```bash
sudo apt install stripe
```

#### YUM

> Der RPM-Build für die CLI ist auf JFrog unter https://packages.stripe.dev, verfügbar. Bei dieser Domain handelt es sich nicht um eine Stripe-Domain. Wenn Sie diese URL besuchen, werden Sie zur Jfrog Artifactory-Liste weitergeleitet.

So installieren Sie die Stripe-CLI auf PM-basierten Distributionen:

1. Fügen Sie das yum-Repository der CLI zur Liste der yum-Quellen hinzu:

```bash
echo -e "[Stripe]\nname=stripe\nbaseurl=https://packages.stripe.dev/stripe-cli-rpm-local/\nenabled=1\ngpgcheck=0" >> /etc/yum.repos.d/stripe.repo
```

1. Installieren Sie die CLI:

```bash
sudo yum install stripe
```

#### Scoop

Führen Sie zur Installation der Stripe-CLI mit [Scoop](https://scoop.sh/) Folgendes aus:

```bash
scoop bucket add stripe https://github.com/stripe/scoop-stripe-cli.git
```

```bash
scoop install stripe
```

#### macOS

So installieren Sie die Stripe-CLI auf macOS ohne Homebrew:

1. Laden Sie die neueste tar.gz-Datei Ihres CPU-Architekturtyps für `mac-os` von [GitHub](https://github.com/stripe/stripe-cli/releases/latest) herunter.
1. Dekomprimieren Sie die Datei: `tar -xvf stripe_[XXX]_mac-os_[ARCH_TYPE].tar.gz`.

Installieren Sie optional die Binärdatei in einem Verzeichnis, in dem Sie sie global ausführen können (zum Beispiel `/usr/local/bin`).

#### Linux

So installieren Sie die Stripe-CLI unter Linux ohne einen Paketmanager:

1. Laden Sie die neueste tar.gz-Datei für `linux` von [GitHub](https://github.com/stripe/stripe-cli/releases/latest) herunter.
1. Dekomprimieren Sie die Datei: `tar -xvf stripe_X.X.X_linux_x86_64.tar.gz`.
1. Verschieben Sie `./stripe` in Ihren Ausführungspfad.

#### Windows

Führen Sie zur Installation der Stripe-CLI unter Windows ohne Scoop Folgendes aus:

1. Laden Sie die neueste Zip-Datei für `windows` von [GitHub](https://github.com/stripe/stripe-cli/releases/latest) herunter.
1. Dekomprimieren Sie die Datei `stripe_X.X.X_windows_x86_64.zip`.
1. Fügen Sie den Pfad zur dekomprimierten `stripe.exe`-Datei zu Ihrer Umgebungsvariable `Path` hinzu. Informationen zum Aktualisieren von Umgebungsvariablen finden Sie in der [Microsoft PowerShell-Dokumentation](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_environment_variables?view=powershell-7.3#saving-changes-to-environment-variables).

> Windows-Antivirenscanner kennzeichnen die Stripe-CLI gelegentlich als unsicher. Dies ist wahrscheinlich ein Fehlalarm. Weitere Informationen finden Sie unter [Problem #692](https://github.com/stripe/stripe-cli/issues/692) im GitHub-Repository.

1. Führen Sie die dekomprimierte `.exe`-Datei aus.

#### Docker

Die Stripe-CLI ist auch als [Docker Image](https://hub.docker.com/r/stripe/stripe-cli) verfügbar. Führen Sie zur Installation der neuesten Version Folgendes aus:

```bash
docker run --rm -it stripe/stripe-cli:latest
```

### Authentifizieren

Melden Sie sich an und authentifizieren Sie Ihr Stripe Nutzer-[Konto](https://docs.stripe.com/get-started/account/set-up.md), um eine Reihe von eingeschränkten Schlüsseln zu generieren. Weitere Informationen finden Sie unter [Stripe-CLI-Schlüssel und -Berechtigungen](https://docs.stripe.com/stripe-cli/keys.md).

```bash
  stripe login
```

Drücken Sie die **Eingabetaste** auf Ihrer Tastatur, um den Authentifizierungsvorgang in Ihrem Browser abzuschließen.

```bash
Your pairing code is: enjoy-enough-outwit-win
This pairing code verifies your authentication with Stripe.
Press Enter to open the browser or visit https://dashboard.stripe.com/stripecli/confirm_auth?t=THQdJfL3x12udFkNorJL8OF1iFlN8Az1 (^C to quit)
```

### Einrichtung bestätigen

Nachdem Sie die CLI installiert haben, können Sie eine einzelne API-Anfrage zum [Erstellen eines Produkts](https://docs.stripe.com/api/products/create.md) tätigen.

#### Bash

```bash
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, wird die folgende Antwort in der Befehlszeile angezeigt.

#### Bash

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

Rufen Sie als Nächstes [Preis erstellen](https://docs.stripe.com/api/prices/create.md) auf, um einen Preis in Höhe von 30 USD anzufügen. Ersetzen Sie den Platzhalter in `product` durch Ihre Produktkennung (z. B. `prod_LTenIrmp8Q67sa`).

#### Bash

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

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

#### Bash

```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"
}
```

## Abhängigkeiten von Drittanbietern verwalten

Wir empfehlen, Abhängigkeiten von Drittanbietern aus [Packagist](https://packagist.org/) mit [Composer](https://getcomposer.org/download/) zu verwalten. Damit können Sie neue Bibliotheken hinzufügen und in Ihre PHP-Projekte aufnehmen.

### Composer installieren

[Laden Sie Composer](https://getcomposer.org/download/) gemäß den Anweisungen über die Befehlszeile herunter.

## Serverseitiges PHP-SDK installieren

Die aktuelle Version des serverseitigen PHP-SDK von Stripe ist v20.2.0. Sie unterstützt die PHP-Versionen 5.6.0+.

Prüfen Sie Ihre PHP-Version:

```bash
php --version
```

### Bibliothek installieren

Installieren Sie die Bibliothek mit [Composer](http://getcomposer.org/), einem Paketmanager für PHP:

```bash
composer require stripe/stripe-php
```

Nachdem Sie die Bibliothek mit Composer installiert haben, wird sie automatisch als Abhängigkeit in der Datei composer.json des Projekts hinzugefügt. Beispiel:

```json
{
    "require": {
        "stripe/stripe-php": "^20.2.0"
    }
}
```

Um Bindings zu nutzen, verwenden Sie die [Autoload](https://getcomposer.org/doc/01-basic-usage.md#autoloading)-Funktion von Composer. Beispiel:

```php
require_once('vendor/autoload.php');
```

### Alternative Installationsmöglichkeiten

**Manuelle Installation**

Sie können [das letzte Release herunterladen](https://github.com/stripe/stripe-php/releases), um die Bindings zu nutzen, und dann die Datei init.php aufnehmen:

```php
require_once('/path/to/stripe-php/init.php');
```

Fügen Sie dann die folgenden Erweiterungen hinzu: [cURL](https://secure.php.net/manual/en/book.curl.php) (oder verwenden Sie optional einen anderen Client als Curl) [json](https://secure.php.net/manual/en/book.json.php) [mbstring](https://secure.php.net/manual/en/book.mbstring.php)

## Ihre erste SDK-Anfrage ausführen

Nachdem Sie das PHP-SDK installiert haben, können Sie mit nur wenigen API-Anfragen ein Abonnement-[Produkt](https://docs.stripe.com/api/products/create.md) erstellen und diesem einen [Preis](https://docs.stripe.com/api/prices/create.md) zuordnen. In diesem Beispiel erstellen wir den Preis mit der in der Antwort zurückgegebenen Produktkennung.

> #### Best Practices für API-Schlüssel verwenden
> 
> In diesem Beispiel werden die Standardschlüssel Ihres Stripe-Nutzer-[Kontos](https://docs.stripe.com/get-started/account/set-up.md) für Ihre *Sandbox*-Umgebung verwendet. Nur Sie können diese Werte sehen. Befolgen Sie [Best Practices](https://docs.stripe.com/keys-best-practices.md), um Ihre Schlüssel sicher zu verwalten.

#### Produkt und Preis erstellen

```php
<?php
require_once('vendor/autoload.php');

# Don't embed any keys in production code. This is an example.
# See https://docs.stripe.com/keys-best-practices.
$stripe = new \Stripe\StripeClient("sk_test_BQokikJOvBiI2HlWgH4olfQ2");

$product = $stripe->products->create([
  'name' => 'Starter Subscription',
  'description' => '$12/Month subscription',
]);
echo "Success! Here is your starter subscription product id: " . $product->id . "\n";

$price = $stripe->prices->create([
  'unit_amount' => 1200,
  'currency' => 'usd',
  'recurring' => ['interval' => 'month'],
  'product' => $product['id'],
]);
echo "Success! Here is your starter subscription price id: " . $price->id . "\n";

?>
```

Speichern Sie die Datei als `create_price.php`. Wechseln Sie in der Befehlszeile mit `cd` zu dem Verzeichnis mit der Datei, die Sie gerade gespeichert haben. Führen Sie dann Folgendes aus:

#### create_price.php

```bash
php create_price.php

```

Wenn alles funktioniert, wird die folgende Antwort in der Befehlszeile angezeigt. Speichern Sie diese Kennungen, damit Sie sie beim Erstellen der Integration verwenden können.

#### bash

```bash
Success! Here is your starter subscription product id: price_0KxBDl589O8KAxCG1alJgiA6
Success! Here is your starter subscription price id: price_0KxBDm589O8KAxCGMgG7scjb
```

## See also

Damit ist dieser Quickstart-Leitfaden abgeschlossen. Über die unten stehenden Links finden Sie weitere Möglichkeiten dazu, wie Sie Zahlungen für gerade erstellte Produkte verarbeiten.

- [Zahlungslink erstellen](https://docs.stripe.com/payment-links.md)
- [Von Stripe gehostete Seite](https://docs.stripe.com/checkout/quickstart.md)
- [Erweiterte Integration](https://docs.stripe.com/payments/quickstart-checkout-sessions.md)