Weiter zum Inhalt
Konto erstellen
 oder
anmelden
Das Logo der Stripe-Dokumentation
/
Konto erstellen
Anmelden
ÜbersichtAktualisieren Sie Ihre Integration
Online-Zahlungen
ÜbersichtIhren Use case findenZahlungen verwalten
Zahlungsmethoden
Zahlungsschnittstellen
Zahlungsszenarien
Präsenzzahlungen
Mehr als Zahlungen

Aktionen mit Webhooks auslösen

So verwenden Sie Webhooks, um Offline-Zahlungen zu verarbeiten

Ein Webhook ist ein HTTP-Endpoint, der Ereignisse von Stripe empfängt.

Durch Webhooks können Sie unter anderem über folgende, Zahlungsereignisse außerhalb Ihres Zahlungsvorgangs benachrichtigt werden:

  • Erfolgreiche Zahlungen (payment_intent.succeeded)
  • Angefochtene Zahlungen (charge.dispute.created)
  • Auf Ihrem Stripe-Konto verfügbares Guthaben (balance.available)

Während das Dashboard ideal für einmalige Aktionen wie die Rückerstattung einer Zahlung oder die Aktualisierung von Kundeninformationen geeignet ist, helfen Webhooks bei der Skalierung Ihrer Zahlungsinformationen und bei der Verarbeitung großer Mengen unternehmenskritischer Ereignisse.

Erstellen Sie Ihren eigenen Webhook

Sie können auf Ihrem eigenen Server einen Webhook-Handler erstellen, der all Ihre Zahlungsabläufe offline verwaltet. Beginnen Sie, indem Sie einen Endpoint bereitstellen, der Anfragen von Stripe empfangen kann und verwenden Sie die CLI, um Ihre Integration lokal zu testen. Jede Anfrage von Stripe enthält ein Ereignis-Objekt mit einer Referenz zu dem Objekt in Stripe, das geändert wurde.

Erstellen Sie einen Webhook-Endpoint

Fügen Sie einen neuen Endpoint in Ihrer Anwendung hinzu. Sie können auf bestimmte Ereignisse reagieren, indem Sie das Feld type des Ereignisses auswählen, das im Haupttext der Anfrage gesendet wurde. Dann können Sie die Standardausgabe drucken, um sich zu vergewissern, dass der Webhook funktioniert.

Starten Sie nach Hinzufügen des neuen Endpoints Ihren Server.

Ruby
Python
PHP
Java
Node
Go
.NET
No results
// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
const stripe = require('stripe')(
'sk_test_BQokikJOvBiI2HlWgH4olfQ2'
);

// This example uses Express to receive webhooks
const app = require('express')();

// Use body-parser to retrieve the raw body as a buffer
const bodyParser = require('body-parser');

// Match the raw body to content type application/json
app.post('/webhook', bodyParser.raw({type: 'application/json'}), (request, response) => {
  const event = request.body;

  // Handle the event
  switch (event.type) {
    case 'payment_intent.succeeded':
      const paymentIntent = event.data.object;
      console.log('PaymentIntent was successful!');
      break;
    case 'payment_method.attached':
      const paymentMethod = event.data.object;
      console.log('PaymentMethod was attached to a Customer!');
      break;
    // ... handle other event types
    default:
      console.log(`Unhandled event type ${event.type}`);
  }

  // Return a 200 response to acknowledge receipt of the event
  response.json({received: true});
});

app.listen(4242, () => console.log('Running on port 4242'));

Installieren und richten Sie die Stripe-CLI ein

Command Line
Homebrew
Aus Quelle installieren
No results
# Install Homebrew to run this command: https://brew.sh/
brew install stripe/stripe-cli/stripe

# Connect the CLI to your dashboard
stripe login

Weitere Installationsoptionen finden Sie unter Mit der Stripe-CLI loslegen.

Führen Sie nach Installieren der Stripe-CLI in der Kommandozeile stripe login aus, um einen Kopplungscode zu generieren, der eine Verknüpfung zu Ihrem Stripe-Konto herstellt. Drücken Sie auf Eingabe, um Ihren Browser zu starten und sich in Ihrem Stripe-Konto anzumelden, um den Zugriff zu genehmigen. Der erstellte API-Schlüssel ist 90 Tage lang gültig. Sie können den Schlüssel unter API-Schlüssel im Dashboard ändern oder löschen.

Notiz

Sie können eine projektspezifische Konfiguration erstellen, indem Sie bei der Anmeldung und beim Ausführen von Befehlen für dieses Projekt das Flag –project-name einfügen.

Test

Command Line
stripe login
Your pairing code is: humour-nifty-finer-magic
Press Enter to open up the browser (^C to quit)

Wenn Sie einen bestehenden API-Schlüssel nutzen möchten, verwenden Sie die Markierung --api-key:

Command Line
stripe login --api-key 
sk_test_BQokikJOvBiI2HlWgH4olfQ2

Your pairing code is: humour-nifty-finer-magic
Press Enter to open up the browser (^C to quit)

Testen Sie Ihren Webhook lokal

Verwenden Sie die CLI, um Ereignisse an Ihren lokalen Webhook-Endpoint mithilfe des Befehls listen weiterzuleiten.

Sofern Ihre Anwendung auf dem Port 4242 ausgeführt wird, führen Sie Folgendes aus:

Command Line
stripe listen --forward-to http://localhost:4242/webhook

Verwenden Sie in einer anderen Terminal-Registerkarte den CLI-Befehl trigger, um ein Probe-Webhook-Ereignis auszulösen.

Command Line
stripe trigger payment_intent.succeeded

Das folgende Ereignis wird in Ihrer Registerkarte listen angezeigt:

Command Line
[200 POST] OK payment_intent.succeeded

„PaymentIntent war erfolgreich!“ erscheint auf der Terminal-Registerkarte, auf der Ihr Server ausgeführt wird, sehen.

Stellen Sie Ihren Webhook-Endpoint bereit

Wenn Sie bereit sind, Ihren Webhook-Endpoint für die Produktion bereitzustellen, müssen Sie Folgendes beachten:

  1. Verwenden Sie Ihre Live-Modus-API-Schlüssel, nicht Ihre Testschlüssel.

  2. Konfigurieren Sie Ihren Webhook-Endpoint in Workbench oder über die API.

Um Ihren Endpoint in Workbench zu konfigurieren, gehen Sie auf die Registerkarte Webhooks.

Klicken Sie auf Ziel hinzufügen und geben Sie die Stripe-API-Version und die spezifischen Ereignisse ein, die Stripe senden soll. Klicken Sie auf Fortfahren und wählen Sie Webhook-Endpoint aus der Liste der verfügbaren Zieltypen. Klicken Sie auf Weiter und geben Sie die URL Ihres Endpoints, einen optionalen Namen und eine optionale Beschreibung ein. Klicken Sie auf Ziel erstellen.

Ersetzen Sie das Geheimnis für den Webhook-Endpoint in Ihrer Anwendung durch das neue Geheimnis, das in der Zielansicht in Workbench für Ihren Endpoint angezeigt wird.

Ihre Anwendung kann jetzt Live-Ereignisse empfangen. Weitere Informationen zum Konfigurieren Ihres Webhook-Endpoints finden Sie in der Webhook Endpoint API. Informationen zum Testen in einer Sandbox finden Sie in unserem Entwicklungsleitfaden.

War diese Seite hilfreich?
JaNein