Ältere ErweiterungenVeraltet

Sie können diese Einstellung im Abschnitt Integration in den Erweiterungs-Einstellungen konfigurieren.

Starten Sie Ihre Integration, indem Sie die Schaltfläche umschalten, um das Onboarding von Standard-Konten mit OAuth zu aktivieren. Erweiterungen sollten OAuth mit Express-Konten nicht nutzen.

Stripe provides a unique identifier for your extension called a client_id. You set the redirect_uri and users are directed to that page after they connect their accounts. You must specify all redirect URIs in your extension settings. The development and production versions of these two values help with testing. Take note of these values so you can create an OAuth link in the third step.

Sie können das Erscheinungsbild Ihres Unternehmens für Ihre Nutzer/innen in den Erweiterungs-Einstellungen unter Branding anpassen.

Nutzer/innen sehen Ihr Logo, wenn sie ihre Stripe-Konten mit Ihrer Anwendung verknüpfen. Nachdem die Konten verknüpft wurden, wird Ihr Symbol in der Liste der verbundenen Anwendungen angezeigt.

Stripe stellt für die Verbindung mit Stripe-Konten einen Standard-OAuth 2.0-Ablauf zur Verfügung. Mit den Werten client_id und redirect_uri aus Schritt 1 können Sie einen OAuth-Link für Ihre Nutzer/innen erstellen, um sie zum Onboarding einzuladen. Wir empfehlen, diesen Link mit der Schaltfläche Mit Stripe verbinden anzuzeigen, die Nutzer/innen an den Endpoint authorize_url sendet:

https://connect.stripe.com/oauth/authorize?response_type=code&client_id=ca_FkyHCg7X8mlvCUdMDao4mMxagUfhIwXb&scope=read_only

So können Sie Ihrem/Ihrer Nutzer/in den obigen Link zusammen mit der Mit Stripe verbinden-Schaltfläche präsentieren:

Sobald der/die Nutzer/in den Link auf Ihrer Website anklickt, leiten wir ihn/sie auf eine Seite weiter, um die Verbindung zu Ihrer Erweiterung zu gewähren oder zu verweigern. Der Autorisierungsablauf von Stripe fordert ihn/sie auf, entweder ein bestehendes Konto auszuwählen, um eine Verbindung zu Ihrer Erweiterung herzustellen, oder ein neues zu erstellen.

Nachdem ein/e Nutzer/in sein/ihr neu erstelltes Konto mit Ihrer Erweiterung verbunden hat, leiten wir ihn/sie auf die URL weiter, die Sie als redirect_uri Ihrer Plattform festgelegt haben.

Am Ende des OAuth-Arbeitsablaufs erhalten Sie die Anmeldedaten für die Autorisierung des Nutzerkontos:

{
  ...
  "stripe_user_id": "acct_0123456789",
  ...
}

Sie müssen die stripe_user_id speichern, damit Sie Ihre Nutzerkonten identifizieren können.

Nachdem Nutzer/innen ihre Stripe-Konten mit Ihrer Anwendung verknüpft haben, können Sie API-Anfragen in ihrem Namen durchführen. Zur Durchführung von API-Anfragen benötigen Sie den geheimen Schlüssel Ihres Erweiterungskontos und einen Stripe-Account-Header, der das Konto identifiziert, für das Sie die Anfrage durchführen. Alle Stripe-Bibliotheken unterstützen diese Art der Authentifizierung pro Anfrage.

Abrufen gespeicherter Daten

Zu den gespeicherten Daten gehören u. a. Informationen zu Zahlungen und Kundendaten. Mit read_only-Zugriff können Sie die meisten GET-Anfragen in der API von Stripe durchführen. Sie können ein einzelnes Objekt (zum Beispiel Abruf eines Payment Intent) oder eine Liste von Objekten (zum Beispiel Liste aller Payment Intents) abrufen.

curl https://api.stripe.com/v1/payment_intents \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d "created[lte]"=1612048287 \
  -d "limit"=50 \
  -H "Stripe-Account: {{CONNECTED_ACCOUNT_ID}}"

Auch wenn die API hochleistungsfähig ist, verlangsamt das wiederholte Abrufen von großen Datensätzen jedoch die Reaktionsfähigkeit Ihrer Anwendung. Wir empfehlen, die abgerufenen Daten auf Ihrer Seite für Analysen und Berichte zu speichern.

Überwachen auf Echtzeitdaten

Zusätzlich zu den gespeicherten Daten können Sie über Webhooks auf Echtzeitdaten zugreifen. Sobald Sie einen Erweiterungs-Webhook-Endpoint in Ihrem Konto definiert haben, sendet Stripe für jedes verbundene Konto Ereignisbenachrichtigungen an den Endpoint. Die Eigenschaft account des Ereignisobjekts kennzeichnet das Konto, bei dem das Ereignis aufgetreten ist.

Das nachstehende Ereignis zeigt beispielsweise, dass ein Kunde/eine Kundin im Konto acct_0123456789 erstellt wurde. Wir empfehlen auch hier, diese Daten Ihrerseits für Analysen und Berichte zu speichern. Durch die Beobachtung von Ereignissen, während sie auftreten, kann Ihre Anwendung schneller reagieren, und Sie müssen nicht so viele API-Aufrufe tätigen.

{
  "id": "evt_HSC8SN3UYfsdO3",
  "livemode": true,
  "object": "event",
  "type": "customer.created",
  "account": "acct_0123456789",
  "pending_webhooks": 2,
  "created": 1349654313,
  "data": {...}
}