Stripe-Mahnwesen

Ü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

Architektur

Wichtige Template-Dateien

Installiere diese Dateien mit connic init my-project --templates=stripe-dunning. Die CLI legt die Agentendefinitionen unter agents/ in einem Ordner mit dem Namen des Templates ab.

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 über ein verbundenes Git-Repository oder die CLI.

1. 1

   Installieren und Projekt anlegen

   Installiere das SDK und erstelle aus diesem Template ein Projekt.

   terminal

   Copy

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

   Danach cd my-project

2. 2

   Bereitstellen

   Wähle eine Deployment-Methode. Bei einem verbundenen Git-Repository startet jeder Push ein Deployment. Nutze die CLI für Projekte ohne verbundenes Git-Repository.

   Git-Integration

   1. 1

      Verbinde in Connic unter Projekt Settings → Git & Environments das GitHub-Repository

   2. 2

      Ordne auf derselben Seite den Branch (z. B. main) der Produktivumgebung zu

   3. 3

      Pushe das erzeugte Projekt in dieses Repository

   terminal

   Copy

   git add .
   git commit -m "Stripe-Mahnwesen Template hinzufügen"
   git push origin main

   CLI Deployment

   1. 1

      Erstelle in Connic unter Projekt Settings → API Keys & MCP Auth einen API Key und kopiere die Projekt-ID

   2. 2

      Führe im Projektverzeichnis connic login aus

   3. 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

   Copy

   connic login
   connic dev     # Temporäre Entwicklungsumgebung mit Hot Reload
   connic test    # Deklarative Test Suites ausführen
   connic deploy  # In den Produktivbetrieb deployen

3. 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.

   Vollständiger Einrichtungsleitfaden für VerbindungenQuickstart GuideDocs zu Verbindungen