Ihre erste Stripe API-Anfrage senden

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. Mehr zu dem Thema finden Sie außerdem in der API-Dokumentation. Wenn Sie bereit sind, Zahlungen anzunehmen, lesen Sie unseren Quickstart-Leitfaden.

Erkunden Sie die Stripe-APIs mit der Stripe Shell. Mit der Stripe Shell können Sie Stripe-CLI-Befehle direkt auf der Stripe-Dokumentationsseite ausführen. Da die Shell nur im Testmodus ausgeführt werden kann, müssen Sie nicht an das Initiieren von Transaktionen mit echtem Geld denken.

1. Geben Sie den folgenden Befehl ein, um mit Stripe Shell eine Kundin/einen Kunden zu erstellen:

   Command Line

   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:

   {
     "id": 
   "cus_LfctGLAICpokzr",
     "object": 
   "customer",

   Alle 31 Zeilen anzeigen

2. (Optional) Führen Sie denselben Befehl aus, indem Sie Ihren API-Geheimschlüssel für den Test-Modus übergeben:

   Command Line

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

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

   {
     "id": 
   "cus_LfdZgLFhah76qf",
     "object": 
   "customer",

   Alle 32 Zeilen anzeigen

Immer wenn Sie Stripe-APIs aufrufen, erstellt und speichert Stripe die API- und Ereignis-Objekte für Ihr Stripe-Nutzerkonto. Der von Ihnen für die Anfrage angegebene API-Schlüssel bestimmt, ob die Objekte im Test- oder im Live-Modus gespeichert werden. Beispielsweise wurde bei der letzten Anfrage Ihr API-Geheimschlüssel verwendet, sodass Stripe die Objekte im Test-Modus gespeichert hat.

• API-Anfrage-Log anzeigen:

  • Öffnen Sie die Seite Logs.
  • Klicken Sie auf 200 OK POST /v1 customers.

• Ereignis-Log anzeigen:

  • Öffnen Sie die Seite Ereignisse.
  • Klicken Sie auf jane.smith@email.com ist eine neue Kundin.

Alle Konten verfügen standardmäßig über insgesamt vier API-Schlüssel – zwei für den Test-Modus und zwei für den Live-Modus:

• Geheimschlüssel im Test-Modus: Verwenden Sie diesen Schlüssel, um Anfragen auf Ihrem Server im Test-Modus zu authentifizieren. Standardmäßig können Sie diesen Schlüssel verwenden, um jede API-Anfrage ohne Einschränkungen durchzuführen.
• Veröffentlichbarer Schlüssel im Test-Modus: Verwenden Sie diesen Schlüssel zu Testzwecken im clientseitigen Code Ihrer Web- oder Mobil-App.
• Geheimschlüssel für den Live-Modus: Verwenden Sie diesen Schlüssel, um Anfragen auf Ihrem Server im Live-Modus zu authentifizieren. Standardmäßig können Sie diesen Schlüssel verwenden, um jede API-Anfrage ohne Einschränkungen durchzuführen.
• Veröffentlichbarer Schlüssel im Live-Modus: Verwenden Sie diesen Schlüssel im clientseitigen Code Ihrer Web- oder Mobil-App, wenn Sie bereit sind, Ihre App zu starten.

Ihre geheimen und veröffentlichbaren Schlüssel finden Sie in den API-Schlüsseln. Wenn Sie angemeldet sind, füllt die Stripe-Dokumentation die Code-Beispiele automatisch mit Ihren API-Schlüsseln im Test-Modus aus. (Nur Sie können diese Werte sehen). Wenn Sie nicht angemeldet sind, enthalten unsere Code-Beispiele zufällig generierte API-Schlüssel. Sie können diese durch Ihre eigenen Testschlüssel ersetzen oder melden Sie sich an, um die Code-Beispiele mit Ihren Test-API-Schlüsseln anzuzeigen. Wenn Sie Ihre API-Schlüssel nicht anzeigen können, bitten Sie die Inhaberin/den Inhaber Ihres Stripe-Kontos, Sie mit den entsprechenden Berechtigungen zum Team hinzuzufügen.

Die folgende Tabelle zeigt zufällig generierte Beispiele für geheime und veröffentlichbare Test-API-Schlüssel: