Zum Hauptinhalt springen

Stripe-Integration - Einrichtungsanleitung

Verbinde dein Stripe-Konto mit Goodweek, um Zahlungen, Kunden, Abonnements, Rechnungen und Abrechnungsdaten direkt aus deinem KI-Arbeitsbereich zu verwalten.

A
Verfasst von Antoine Stempien

Verbinde dein Stripe-Konto mit Goodweek, um Zahlungen, Kunden, Abonnements, Rechnungen und Abrechnungsdaten direkt aus deinem KI-Arbeitsbereich zu verwalten.

ℹ️ Hinweis zur Governance

Goodweek überschreitet niemals die dem Benutzer innerhalb von Stripe gewährten Zugriffsebenen und gewährleistet so die Übereinstimmung mit den Governance-Richtlinien deiner Organisation. Ergebnisse und verfügbare Funktionen können je nach den spezifischen Berechtigungen und dem authentifizierten Zugriff jedes Benutzers variieren.

📋 Voraussetzungen

Bevor ein Benutzer die Stripe-Integration sehen und verbinden kann, muss der Administrator deiner Organisation sie zunächst im Goodweek-Adminbereich unter dem Tab Integrationen aktivieren.

Admin-Einrichtung

Die Stripe-Integration verwendet OAuth 2.0 und erfordert keine Genehmigung auf Administratorebene innerhalb von Stripe, bevor sich Benutzer verbinden können.

⚠️ Wichtig: Live- vs. Testmodus

Stripe arbeitet in zwei Modi: live und test. Stelle beim Verbinden sicher, dass du dich im richtigen Modus für deinen vorgesehenen Zweck autorisierst. Über Goodweek durchgeführte Aktionen wirken sich auf die Live-Umgebung von Stripe aus, es sei denn, du verbindest ein Testkonto.

Benutzerverbindung

  1. Gehe in Goodweek zu Integrationen.

  2. Suche Stripe und klicke auf Verbinden.

  3. Du wirst zu Stripe weitergeleitet, wo du dich anmelden und den Zugriff autorisieren musst.

  4. Klicke auf Verbinden, um Zugriff zu gewähren und zu Goodweek zurückzukehren.

Wichtige Hinweise

  • Jeder Benutzer muss sein eigenes Stripe-Konto individuell verbinden.

  • Goodweek arbeitet in dem Modus (live oder test) des Kontos, das du autorisierst.

  • Du kannst den Zugriff von Goodweek jederzeit über Stripe Dashboard → Einstellungen → Verbundene Anwendungen → Composio → Trennen widerrufen.


Verfügbare Tools

Tool

Beschreibung

Typ

Kunde erstellen

Erstellt einen neuen Kunden in Stripe, erforderlich zum Erstellen von Belastungen oder Abonnements.

Schreiben

Konto abrufen

Ruft detaillierte Informationen für das authentifizierte Stripe-Konto ab.

Lesen

Zahlungsabsicht erstellen

Erstellt ein Stripe-PaymentIntent, um die Zahlung eines Kunden einzuleiten und zu verarbeiten.

Schreiben

Zahlungsabsicht bestätigen

Bestätigt ein PaymentIntent, um die Zahlung mit der angegebenen Zahlungsmethode abzuschließen.

Lesen

Zahlungsabsicht erfassen

Erfasst Gelder aus einem autorisierten PaymentIntent, wenn es sich im Status requires_capture befindet.

Lesen

Rechnung abrufen

Ruft eine bestimmte Rechnung anhand ihrer ID ab.

Lesen

Rechnung erstellen

Erstellt eine neue Stripe-Entwurfsrechnung für einen Kunden.

Schreiben

Rechnungsposten erstellen

Fügt vor der Finalisierung eine Position zu einer Entwurfsrechnung hinzu.

Schreiben

Positionen zur Rechnung hinzufügen

Fügt mehrere Positionen in einem Aufruf zu einer bestehenden Stripe-Entwurfsrechnung hinzu.

Schreiben

Rechnung finalisieren

Finalisiert eine Entwurfsrechnung und macht sie offen und bereit für den Einzug.

Lesen

Rechnungsposten abrufen

Ruft eine paginierte Liste von Positionen für eine bestimmte Rechnung ab.

Lesen

Gutschrift erstellen

Stellt eine Gutschrift aus, um den Betrag einer finalisierten Rechnung anzupassen.

Schreiben

Gutschrift-Vorschau

Zeigt eine Vorschau einer Gutschrift, ohne sie in Stripe zu erstellen.

Lesen

Kundenabonnement erstellen

Erstellt ein neues Abonnement für einen bestehenden Stripe-Kunden mit Positionen und Preisen.

Schreiben

Abonnement erstellen

Erstellt ein hochkonfigurierbares Abonnement mit Unterstützung für mehrere Positionen, Testphasen und Rabatte.

Schreiben

Kundenabonnement abrufen

Ruft ein bestimmtes Abonnement für einen Kunden ab.

Lesen

Abonnementposten erstellen

Fügt einem bestehenden Abonnement ein neues Element hinzu, ohne vorhandene Elemente zu ändern.

Schreiben

Rückerstattung erstellen

Erstellt eine vollständige oder teilweise Rückerstattung in Stripe für eine Belastung oder ein PaymentIntent.

Schreiben

Belastungsrückerstattung erstellen

Erstellt eine Rückerstattung für eine zuvor erstellte Belastung.

Schreiben

Gutschein erstellen

Erstellt einen neuen Rabattgutschein mit prozentualem oder festem Rabattbetrag.

Schreiben

Aktionscode erstellen

Erstellt einen vom Kunden einlösbaren Aktionscode, der mit einem zugrunde liegenden Gutschein verknüpft ist.

Schreiben

Produkt erstellen

Erstellt ein neues Produkt in Stripe, um eine Ware oder Dienstleistung darzustellen.

Schreiben

Preis erstellen

Erstellt einen neuen Stripe-Preis für ein Produkt und legt dessen Belastungen (einmalig oder wiederkehrend) fest.

Schreiben

Checkout-Sitzung erstellen

Erstellt eine Stripe-Checkout-Sitzung für eine gehostete Zahlungs- oder Abonnementseite.

Schreiben

Zahlungslink erstellen

Erstellt eine gehostete, teilbare Checkout-URL, die direkt an Kunden gesendet werden kann.

Schreiben

Setup-Absicht erstellen

Erstellt ein SetupIntent, um Zahlungsmethodenberechtigungen für die zukünftige Nutzung zu sammeln.

Schreiben

Ereignisse auflisten

Ruft eine Liste der Stripe-Ereignisse der letzten 30 Tage mit Filterung und Paginierung ab.

Lesen

Ereignis abrufen

Ruft Ereignisdetails für ein bestimmtes Stripe-Webhook-Ereignis anhand der ID ab.

Lesen

Berichtslauf erstellen

Erstellt und startet die asynchrone Ausführung eines Stripe-Finanzberichts.

Schreiben

Abrechnungszähler auflisten

Ruft eine Liste der für die nutzungsbasierte Abrechnung konfigurierten Abrechnungszähler ab.

Lesen

Abrechnungszähler erstellen

Erstellt einen Abrechnungszähler zur Verfolgung von Nutzungsereignissen für nutzungsabhängige Preise.

Schreiben

Abrechnungsportal-Sitzung erstellen

Erstellt eine URL für eine Abrechnungsportal-Sitzung, damit Kunden ihre Abonnements und Rechnungen verwalten können.

Schreiben

Steuerberechnung erstellen

Berechnet Steuern für einen Kundenkauf, bevor eine Bestellung erstellt wird.

Schreiben

Überweisung erstellen

Erstellt eine Überweisung, um im Rahmen von Connect Gelder zwischen Stripe-Konten zu verschieben.

Schreiben

Zahlungsabsicht stornieren

Storniert ein PaymentIntent, das nicht mehr benötigt wird.

⚠️ Destruktiv

Abonnement kündigen

Kündigt das aktive Stripe-Abonnement eines Kunden.

⚠️ Destruktiv

Kunde löschen

Löscht einen Kunden dauerhaft und kündigt dessen aktive Abonnements.

⚠️ Destruktiv

Entwurfsrechnung löschen

Löscht eine Entwurfsrechnung dauerhaft. Diese Aktion kann nicht rückgängig gemacht werden.

⚠️ Destruktiv

Rechnung stornieren

Markiert eine finalisierte Rechnung dauerhaft als storniert und verhindert den Einzug.

⚠️ Destruktiv

Produkt löschen

Löscht ein Produkt aus Stripe. Nur möglich, wenn keine Preise damit verknüpft sind.

⚠️ Destruktiv

Anwendungsfälle

  • Rechnungen erstellen und Zahlungen direkt aus Unterhaltungen einziehen. Erstelle Stripe-Rechnungen, füge Positionen hinzu, finalisiere sie und erstelle Zahlungslinks direkt aus Goodweek — nützlich, um Kunden bei Bedarf abzurechnen, ohne im Stripe-Dashboard zu navigieren.

  • Abonnements und Kunden verwalten. Erstelle neue Abonnements, füge Produkte zu bestehenden hinzu und rufe Abonnementdetails für bestimmte Kunden aus Goodweek ab, um Abrechnungsänderungen schnell zu bearbeiten.

  • Rückerstattungen und Gutschriften ausstellen. Erstelle Rückerstattungen für Belastungen oder Zahlungsabsichten und stelle Gutschriften für finalisierte Rechnungen aus Goodweek aus, wenn du Kundenstreitigkeiten oder Abrechnungskorrekturen bearbeitest.

  • Ereignisse und Abrechnungsaktivitäten überwachen. Rufe aktuelle Stripe-Ereignisse ab und filtere sie nach Typ aus Goodweek, um Zahlungsprobleme, Abonnementänderungen oder Webhook-Aktivitäten zu untersuchen, ohne das Stripe-Dashboard zu verwenden.


Fehlerbehebung

Aktionen betreffen die falsche Stripe-Umgebung

Überprüfe, ob du Goodweek mit dem richtigen Stripe-Konto (live oder test) autorisiert hast. Trenne die Verbindung und verbinde dich bei Bedarf erneut, wobei du darauf achtest, während des Stripe-Autorisierungsprozesses das richtige Konto auszuwählen.

Integration in Goodweek nicht sichtbar

Stelle sicher, dass der Administrator deiner Organisation die Stripe-Integration im Goodweek-Adminbereich unter dem Tab Integrationen aktiviert hat.

Referenzen

Hat dies deine Frage beantwortet?