Zum Hauptinhalt springen
Connic
Verbindungen

Stripe

Stripe-Webhook-Events starten Agenten für Mahnwesen, Onboarding, Betrugserkennung und weitere Aufgaben.

Zuletzt aktualisiert
Auf dieser Seite
Inbound-Modus
Stripe-Events starten Agent Runs asynchron. Das eignet sich für zahlungsgesteuerte Workflows wie Mahnwesen, Onboarding und Betrugserkennung.

Funktionsweise

Die Stripe-Verbindung empfängt Webhook-Events aus dem Stripe-Account, prüft die Signatur und startet verknüpfte Agenten mit der vollständigen Event-Payload. Besonders geeignet für Mahnwesen, Onboarding nach einem Upgrade, Betrugserkennung und Churn-Prävention.

Einrichtung

1

Verbindung in Connic erstellen

Erstelle eine neue Stripe-Verbindung im Projekt und gib ihr einen Namen.

2

Webhook-URL kopieren

Kopiere nach dem Erstellen der Verbindung die Webhook-URL aus ihrer Detailansicht.

3

Webhook im Stripe Dashboard hinzufügen

Öffne Stripe Dashboard > Developers > Webhooks > Add endpoint. Füge die Webhook-URL ein und wähle die zu empfangenden Events aus.

4

Signing Secret einfügen

Kopiere das Signing Secret aus Stripe (es beginnt mit whsec_), füge es in die Einstellungen der Verbindung ein und klicke auf Save.

Wichtig: Die Verbindung verarbeitet erst Events, nachdem das Signing Secret hinzugefügt wurde. Damit wird geprüft, ob alle Webhooks tatsächlich von Stripe stammen.

Event-Payload

Der Agent erhält das vollständige Stripe-Event-Objekt als Input:

event-payload.json
{
  "id": "evt_1234567890",
  "object": "event",
  "type": "payment_intent.payment_failed",
  "data": {
    "object": {
      "id": "pi_1234567890",
      "amount": 2000,
      "currency": "eur",
      "customer": "cus_1234567890",
      "last_payment_error": {
        "code": "card_declined",
        "message": "Your card was declined."
      }
    }
  }
}

Beispiel für ein Subscription-Event

subscription-event.json
{
  "id": "evt_1234567890",
  "object": "event",
  "type": "customer.subscription.updated",
  "data": {
    "object": {
      "id": "sub_1234567890",
      "customer": "cus_1234567890",
      "status": "active",
      "plan": {
        "id": "plan_pro",
        "amount": 4900,
        "interval": "month"
      }
    }
  }
}

Beispiel-Agent

agents/dunning-agent.yaml
name: dunning-agent
model: connic/gpt-5.6-terra
system: |
  You are a dunning specialist AI. When a payment fails,
  analyze the customer's history and generate a personalized
  recovery message.

# Das Stripe-Event wird als Input übergeben
# Zugriff in der Middleware: input["data"]["object"]["last_payment_error"]
Signaturprüfung

Connic prüft den Header Stripe-Signature mit dem Signing Secret. Ungültige Signaturen werden abgelehnt.

  • HMAC-SHA256-Prüfung
  • Zeitstempelprüfung zum Schutz vor Replay-Angriffen
  • Rate Limiting

Verbindungen entdecken

Verbindungsmodi

Mehr über Verbindungsmodi erfahren

HTTP Webhooks

Allgemeine Webhook-Integration

Agentenkonfiguration

Agenten für Stripe-Events konfigurieren

Middleware

Stripe-Daten in Python verarbeiten