Ihre erste Stripe API-Anfrage senden
Jeder Aufruf einer Stripe-API muss einen API-Geheimschlüssel enthalten. Nachdem Sie ein Stripe-Konto erstellt haben, generieren wir zwei API-Schlüsselpaare für Sie – einen veröffentlichbaren clientseitigen Schlüssel und einen geheimen serverseitigen Schlüssel – für den Test-Modus und den Live-Modus. Um echte Geldbewegungen mit Ihren Live-Modus-Schlüsseln durchzuführen, müssen Sie Ihr Konto aktivieren.
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. Mehr zu dem Thema finden Sie außerdem in der API-Dokumentation. Wenn Sie bereit sind, Zahlungen anzunehmen, lesen Sie unseren Quickstart-Leitfaden.
Ihre erste API-Anfrage senden
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.
Geben Sie den folgenden Befehl ein, um mit Stripe Shell eine Kundin/einen Kunden zu erstellen:
Command Linestripe 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":
, "object":"cus_LfctGLAICpokzr","customer"(Optional) Führen Sie denselben Befehl aus, indem Sie Ihren API-Geheimschlüssel für den Test-Modus übergeben:
Command Linestripe 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":
, "object":"cus_LfdZgLFhah76qf","customer"
Logs und Ereignisse 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.
Ihre API-Schlüssel speichern
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.
Tests und Entwicklung
Verwenden Sie nur Ihre Test-API-Schlüssel für Tests und Entwicklung. So wird sichergestellt, dass Sie Ihre Live-Kunden oder Zahlungen nicht versehentlich ändern.
You can find your secret and publishable keys in API keys. When you’re logged in, Stripe’s documentation automatically populates code examples with your test mode API keys (only you can see these values). If you’re not logged in, our code examples include randomly generated API keys. You can replace them with your own test keys or log in to see the code examples populated with your test API keys. If you can’t view your API keys, ask the owner of your Stripe account to add you to their team, with the proper permissions.
Die folgende Tabelle zeigt zufällig generierte Beispiele für geheime und veröffentlichbare Test-API-Schlüssel:
Eingeschränkte API-Schlüssel
The Dashboard can also generate restricted API keys, enabling customizable and limited access to the API. However, Stripe doesn’t offer any restricted keys by default.
Typ | Wert | Wann diese eingesetzt werden |
---|---|---|
Geheim | Auf dem Server: Muss geheim und sicher im serverseitigen Code Ihrer Web- oder Mobil-App gespeichert sein (z. B. in einem Verwaltungssystem für Umgebungsvariablen oder Anmeldedaten), um Stripe-APIs aufzurufen. Stellen Sie diesen Schlüssel nicht auf einer Website zur Verfügung und betten Sie ihn nicht in eine mobile Anwendung ein. | |
Veröffentlichbar | Auf dem Client: Kann im clientseitigen Code Ihrer Web- oder Mobil-App (z. B. checkout.js) öffentlich zugänglich sein, um z. B. mit Stripe Elements Zahlungsinformationen sicher zu erfassen. Standardmäßig erfasst Stripe Checkout Zahlungsinformationen auf sichere Weise. | |
Eingeschränkt | Eine Zeichenfolge, die mit rk_test_ beginnt. | Über Microservices: Muss geheim und sicher in Ihrem Microservice-Code gespeichert sein, um Stripe-APIs aufzurufen. Veröffentlichen Sie diesen Schlüssel nicht auf Ihrer Website und betten Sie diesen auch nicht in eine mobile Anwendung ein. |