# Ihre erste Stripe API-Anfrage senden

Mit der Stripe API loslegen.

Jeder Aufruf einer Stripe-API muss einen API-Geheimschlüssel enthalten. Nachdem Sie ein Stripe-Konto erstellt haben, generieren wir zwei Paare von [API-Schlüsseln](https://docs.stripe.com/keys.md) für Sie – einen veröffentlichbaren clientseitigen Schlüssel und einen serverseitigen Geheimschlüssel – sowohl für Tests im *Sandbox-Modus* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes) als auch im *Live-Modus* (Use this mode when you’re ready to launch your app. Card networks or payment providers process payments). Um mit Ihren Live-Modus-Schlüsseln echte Geldtransaktionen durchzuführen, müssen Sie [Ihr Stripe-Konto einrichten](https://docs.stripe.com/get-started/account/set-up.md).

## Bevor Sie beginnen

Dieser Leitfaden führt Sie durch eine einfache Interaktion mit der Stripe API: das Erstellen einer Kundin/eines Kunden. Damit Sie die Objekte der Stripe API, und wie diese miteinander agieren, besser nachvollziehen können, [führen wir Sie durch unsere API-Optionen](https://docs.stripe.com/payments-api/tour.md). Mehr zu dem Thema finden Sie außerdem in der [API-Dokumentation](https://docs.stripe.com/api.md). Wenn Sie bereit sind, Zahlungen anzunehmen, lesen Sie unseren [Quickstart-Leitfaden](https://docs.stripe.com/payments/quickstart.md).

## Ihre erste API-Anfrage senden

Erkunden Sie die Stripe-APIs mit der [Stripe Shell](https://docs.stripe.com/workbench/shell.md). Mit der Stripe Shell können Sie Stripe-CLI-Befehle direkt auf der Stripe-Dokumentationsseite ausführen. Da die Shell nur in einer *Sandbox* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes)-Umgebung ausgeführt werden kann, müssen Sie sich keine Sorgen bezüglich der Einleitung von Transaktionen mit echtem Geld denken.

1. Geben Sie den folgenden Befehl ein, um mit Stripe Shell [eine Kundin/einen Kunden zu erstellen](https://docs.stripe.com/api/customers/create.md):

   #### bash

   ```bash
   stripe customers create --email=jane.smith@email.com --name="Jane Smith" --description="My First Stripe Customer"
   ```

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

   #### bash

   ```json
   {
     "id": "cus_LfctGLAICpokzr", // Die Kennung sieht wie folgt aus.
     "object": "customer", // Das ist das für Ihr Konto aufgezeichnete Objekt.
     "address": null,
     "balance": 0,
     "created": 1652283583,
     "currency": null,
     "default_source": null,
     "delinquent": false,
     "description": "My First Stripe Customer",
     "discount": null,
     "email": "jane.smith@email.com",
     "invoice_prefix": "9B1D61CF",
     "invoice_settings": {
       "custom_fields": null,
       "default_payment_method": null,
       "footer": null
     },
     "livemode": false,
     "metadata": {
     },
     "name": "Jane Smith",
     "next_invoice_sequence": 1,
     "phone": null,
     "preferred_locales": [
   
     ],
     "shipping": null,
     "tax_exempt": "none",
     "test_clock": null
   }
   ```

2. (Optional) Führen Sie denselben Befehl aus, indem Sie Ihren geheimen API-Schlüssel in einer Sandbox übergeben:

   #### bash

   ```bash
   stripe customers create --email=jane.smith@email.com --name="Jane Smith" --description="My First Stripe Customer" --api-key sk_test_BQokikJOvBiI2HlWgH4olfQ2
   ```

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

   #### bash

   ```json
   {
     "id": "cus_LfdZgLFhah76qf", // Die Kennung sieht wie folgt aus.
     "object": "customer", // Das ist das für Ihr Konto aufgezeichnete Objekt.
     "address": null,
     "balance": 0,
     "created": 1652286103,
     "currency": null,
     "default_currency": null,
     "default_source": null,
     "delinquent": false,
     "description": "My First Stripe Customer",
     "discount": null,
     "email": "jane.smith@email.com",
     "invoice_prefix": "D337F99E",
     "invoice_settings": {
       "custom_fields": null,
       "default_payment_method": null,
       "footer": null
     },
     "livemode": false,
     "metadata": {
     },
     "name": "Jane Smith",
     "next_invoice_sequence": 1,
     "phone": null,
     "preferred_locales": [
   
     ],
     "shipping": null,
     "tax_exempt": "none",
     "test_clock": null
   }
   ```

## Logs und Ereignisse anzeigen

Wenn Sie Stripe-APIs aufrufen, erstellt und speichert Stripe die API- und [Ereignis](https://docs.stripe.com/api/events.md)-Objekte für Ihr Stripe-[Nutzerkonto](https://docs.stripe.com/get-started/account.md). Der für die Anfrage angegebene API-Schlüssel bestimmt, ob die Objekte in einer Sandbox-Umgebung oder im Live-Modus gespeichert werden. Beispielsweise wurde bei der letzten Anfrage Ihr geheimer API-Schlüssel verwendet, sodass Stripe die Objekte in einer Sandbox gespeichert hat.

- API-Anfrage-Log anzeigen:

  - Öffnen Sie die Seite [Logs](https://dashboard.stripe.com/test/workbench/logs).
  - Klicken Sie auf **200 OK POST /v1 customers**.

- Ereignis-Log anzeigen:

  - Öffnen Sie die Seite [Ereignisse](https://dashboard.stripe.com/test/workbench/events).
  - Klicken Sie auf **jane.smith@email.com ist eine neue Kundin**.

## Ihre API-Schlüssel speichern

Wenn Sie sich für ein Stripe-Konto registrieren, erstellen wir drei Arten von API-Schlüsseln für Sie:

| Typ | Bedenkenlos bereitstellbar | Beschreibung |
| --- | --- | --- |
| Veröffentlichbarer API-Schlüssel `pk_...` | Ja | API-Schlüssel für Stripe.js, Elements und mobile SDKs. Er kann Konten erkennen und Token oder PaymentMethods anhand von Zahlungsdaten erstellen. Es lassen sich damit jedoch keine sensiblen Vorgänge ausführen, wie z. B. Abbuchungen erstellen oder Kontodaten lesen. Sie können den Schlüssel im Front-End-Code oder in von Ihnen bereitgestellten Anwendungen einbinden. |
| Eingeschränkter API-Schlüssel (RAK) `rk_...` | Nein | API-Schlüssel mit von Ihnen kontrollierten Berechtigungen. Begrenzen Sie den Schaden für Ihr Unternehmen, der durch betrügerische Aktivitäten von Personen entstehen kann, die in den Besitz Ihres Schlüssels gelangen. Sie können beliebig viele RAKs erstellen und diese verschiedenen Teilen Ihrer Anwendung zuweisen. Stripe Apps können auch die [RAK-Authentifizierung](https://docs.stripe.com/stripe-apps/api-authentication/rak.md) verwenden, um einen berechtigten Schlüssel zu generieren, wenn ein/e Nutzer/in eine App installiert. [In diesem Leitfaden](https://docs.stripe.com/keys/restricted-api-keys.md) erfahren Sie, wie Sie RAKs konfigurieren und verwenden. |
| Geheimer API-Schlüssel `sk_...` | Nein | API-Schlüssel mit uneingeschränkten Berechtigungen für alle Stripe-APIs. Da Sie deren Berechtigungen nicht einschränken können, empfehlen wir für neue Use Cases keine Geheimschlüssel zu verwenden. Für bestehende Integrationen empfehlen wir, die Nutzung von Geheimschlüsseln auf RAKs zu migrieren. |
| Organisations-API-Schlüssel `sk_org_...` | Nein | API-Schlüssel, der auf Organisationsebene funktioniert. Entspricht eingeschränkten oder geheimen Schlüsseln auf Kontoebene, operiert jedoch auf der [Organisationsebene](https://docs.stripe.com/get-started/account/orgs.md), um mehrere Stripe-Konten gleichzeitig zu verwalten. [Diese Anleitung](https://docs.stripe.com/keys/organization-api-keys.md) erläutert, wie Sie Organisations-API-Schlüssel konfigurieren und verwenden. |

Wir unterstützen außerdem [verwaltete API-Schlüssel](https://docs.stripe.com/keys/managed-api-keys.md), die von bestimmten Hosting-Plattformen ausgestellt werden. Verwaltete Schlüssel sind geheime API-Schlüssel, die eine Hosting-Plattform direkt an Ihre gehosteten Anwendungen übermittelt. Sie müssen verwaltete Schlüssel nicht selbst verwalten – Ihr Hosting-Anbieter stellt sie aus und erneuert sie für Sie.

> #### Webhook-Signaturgeheimnis
> 
> Webhook-Signaturschlüssel sind keine API-Schlüssel, sondern einzelnen Webhooks zugeordnete Schlüssel. Mit ihrer Hilfe kann Ihr Webhook-Empfänger authentifizieren, dass Webhooks tatsächlich von Stripe stammen. Sie finden den Signaturschlüssel für jeden Webhook-Endpoint im Abschnitt [Webhooks](https://dashboard.stripe.com/webhooks) des Dashboards.

Sie sind für die sichere Verwaltung Ihrer API-Schlüssel verantwortlich. Lesen Sie unsere Anleitung zu [Best Practices zum Schutz von API-Schlüsseln](https://docs.stripe.com/keys-best-practices.md).

## See also

- [Entwicklungsumgebung einrichten](https://docs.stripe.com/get-started/development-environment.md)
- [Stripe Shell](https://docs.stripe.com/workbench/shell.md)