Zum Hauptinhalt springen
Connic

Stripe-Mahnwesen

Von Connic

Automatisierte Zahlungserinnerungen helfen, fehlgeschlagene Stripe-Zahlungen nachzuholen. Sie berücksichtigen die Kundenhistorie und reichen von freundlichen Erinnerungen bis zu Hinweisen auf eine Leistungspause.

FinanzenFortgeschrittenStripeE-Mail
connic init my-project --templates=stripe-dunning

Überblick

Die Vorlage verarbeitet Stripe-Webhook-Events zu fehlgeschlagenen Zahlungen und Änderungen an Abonnements. Der Payment Analyzer ruft die Kundenhistorie aus der Datenbank ab, bestimmt die passende Mahnstufe und startet über trigger_agent den Recovery Composer. Middleware filtert irrelevante Stripe-Events mit StopProcessing und übernimmt Kundenmetadaten in den Context. Das mehrstufige Mahnwesen reicht von freundlichen Erinnerungen bis zu Benachrichtigungen über eine Leistungspause.

Use Cases

Ausstehende Zahlungen einziehen

Bei fehlgeschlagenen Abonnementzahlungen werden automatisch zunehmend dringliche, auf die jeweilige Mahnstufe zugeschnittene E-Mails versendet.

Abonnement-Lebenszyklus

Statusänderungen eines Abonnements wie past_due oder cancelled lösen die passende Kundenkommunikation aus.

Rückgewinnungskampagnen

Kündigungen lösen personalisierte Rückgewinnungs-E-Mails aus, die auf die bisherige Nutzung des Kunden zugeschnitten sind.

Architektur

Stripe Webhook
payment-analyzer
recovery-composer
Datenbank für Zahlungsereignisse
Ausgehende E-Mail

Erzeugte Projektstruktur

Der Befehl connic init my-project --templates=stripe-dunning erzeugt diesen Dateibaum.

stripe-dunning/
  agents/
    payment-analyzer.yaml
    recovery-composer.yaml
    dunning-pipeline.yaml
  tools/
    payment_tools.py
  middleware/
    payment-analyzer.py
  schemas/
    payment-analysis.json
    recovery-email.json
  requirements.txt
  README.md

Loslegen

Installiere das Template, erstelle ein Connic-Projekt und starte das Deployment. Mit Git startet jeder Push automatisch ein Deployment; die CLI funktioniert unabhängig vom Git-Anbieter.

Voraussetzungen

  • Python 3.10+
  • Ein Connic-Konto mit einem angelegten Projekt
  • Projektguthaben für ein connic/* KI-Modell oder Zugangsdaten für einen BYOK Provider
Projekt erstellen
1

Installieren und Projekt anlegen

Installiere das SDK und erstelle aus diesem Template ein Projekt.

terminal
pip install connic-composer-sdk
connic init my-project --templates=stripe-dunning

Danach cd my-project

2

Bereitstellen

Als Deployment-Methode stehen Git und CLI zur Auswahl. Bei Git startet jeder Push automatisch ein Deployment; die CLI funktioniert mit GitLab, Bitbucket oder ganz ohne Git.

Git-Integration

  1. Verbinde in Connic unter Projekt Settings → Git & Environments das GitHub-Repository
  2. Ordne auf derselben Seite den Branch (z. B. main) der Produktivumgebung zu
  3. Pushe das erzeugte Projekt in dieses Repository
terminal
git add .
git commit -m "Stripe-Mahnwesen Template hinzufügen"
git push origin main

CLI Deployment

  1. Erstelle in Connic unter Projekt Settings → API Keys & MCP Auth einen API Key und kopiere die Projekt-ID
  2. Führe im Projektverzeichnis connic login aus
  3. Teste mit connic dev und Hot Reload, führe mit connic test Testsuiten aus oder starte mit connic deploy das Deployment für den Produktivbetrieb
terminal
connic login
connic dev     # Temporäre Entwicklungsumgebung mit Hot Reload
connic test    # Deklarative Test Suites ausführen
connic deploy  # In den Produktivbetrieb deployen
3

Verbinden und konfigurieren

Füge eine Stripe-Verbindung hinzu, kopiere die Webhook-URL in das Stripe Dashboard und trage anschließend das Signing Secret ein. Ergänze für die Mahn-E-Mails eine ausgehende E-Mail-Verbindung. Ein connic/* KI-Modell nutzen oder BYOK-Zugangsdaten unter Projekt Settings → LLM Provider hinterlegen.

Template-Quelle

Das vollständige Template lässt sich einsehen, verbessern oder für einen anderen Einsatz forken.

connic-org/connic-awesome-agents/tree/main/stripe-dunning

Informationen

Publisher
Von Connic
Schwierigkeitsgrad
Fortgeschritten
Funktioniert mit
Stripe, E-Mail
Quelle
GitHub