Stripe
Connic prüft die Stripe Webhook-Signatur und leitet das Event an den Agenten weiter. Fehlgeschlagene Zahlungen lösen einen passenden Mahnprozess aus, Upgrades starten Onboarding und Zahlungsstreitigkeiten erhalten einen Antwortentwurf, ohne dass ein eigener Webhook Server nötig ist.
Überblick
Stripe sendet für jedes Zahlungsereignis ein Webhook Event: fehlgeschlagene Zahlungen, geänderte Abonnements oder neue Zahlungsstreitigkeiten. Die Stripe-Verbindung stellt eine Webhook URL bereit, die im Stripe Dashboard als Endpoint registriert wird. Dort werden die Events ausgewählt, Stripe signiert und sendet sie, und Connic prüft jede Signatur und startet die verknüpften Agenten mit dem vollständigen Event-Objekt inklusive Decline Codes und Plan-Details.
Was entfällt, ist der eigene Webhook Service: kein Endpoint zum Hosten, keine Signaturprüfung zum Implementieren und keine eigene Implementierung von Retries und Replay-Schutz. Die Verbindung übernimmt den Empfang; der Agent entscheidet, welche Reaktion eine fehlgeschlagene Zahlung oder Kündigung verdient.
So funktioniert es
Verbindung erstellen
Füge dem Projekt eine Stripe-Verbindung hinzu. Sie benötigt nur einen Namen; Connic erzeugt eine eindeutige Webhook URL.
Endpoint in Stripe hinzufügen
Öffne im Stripe-Dashboard Developers, dann Webhooks und anschließend Add endpoint. Füge die Webhook-URL ein und wähle die gewünschten Events aus.
Signing Secret einfügen
Kopiere das von Stripe für den Endpoint erzeugte Signing Secret (es beginnt mit whsec_) in die Verbindungseinstellungen und speichere es. Ohne dieses Secret verarbeitet die Verbindung keine Events.
Muster für den Produktivbetrieb
Muster für den Produktivbetrieb, bei denen Connic Queues, Worker und Scheduler betreibt.
Zahlung schlägt fehl
payment_intent.payment_failedDer Agent liest den Decline Code, prüft den Lifetime Value und sendet eine auf den Grund abgestimmte Retry-E-Mail. Bei einer abgelaufenen Karte erhält der Kunde eine andere Nachricht als bei unzureichender Deckung.
Zahlung schlägt fehl
payment_intent.payment_failedDer Agent liest den Decline Code, prüft den Lifetime Value und sendet eine auf den Grund abgestimmte Retry-E-Mail. Bei einer abgelaufenen Karte erhält der Kunde eine andere Nachricht als bei unzureichender Deckung.
Abonnement hochgestuft
customer.subscription.updatedDer Agent liest den neuen Plan, entwirft eine Willkommens-E-Mail zu den neu freigeschalteten Features und plant einen Check-in für Tag drei.
Abonnement hochgestuft
customer.subscription.updatedDer Agent liest den neuen Plan, entwirft eine Willkommens-E-Mail zu den neu freigeschalteten Features und plant einen Check-in für Tag drei.
Zahlungsstreitigkeit eröffnet
charge.dispute.createdDer Agent stellt Transaktionshistorie, Produktnutzung und frühere Support-Threads zu einer Antwort im passenden Format für Stripe zusammen und spart dem Finanzteam Stunden pro Fall.
Zahlungsstreitigkeit eröffnet
charge.dispute.createdDer Agent stellt Transaktionshistorie, Produktnutzung und frühere Support-Threads zu einer Antwort im passenden Format für Stripe zusammen und spart dem Finanzteam Stunden pro Fall.
Abonnement gekündigt
customer.subscription.deletedDer Agent prüft Nutzung, Support-Tickets und Kündigungsgrund und sendet ein passendes Win-back-Angebot, etwa einen Rabatt, einen Feature-Hinweis oder ein kurzes Gespräch mit einem Menschen.
Abonnement gekündigt
customer.subscription.deletedDer Agent prüft Nutzung, Support-Tickets und Kündigungsgrund und sendet ein passendes Win-back-Angebot, etwa einen Rabatt, einen Feature-Hinweis oder ein kurzes Gespräch mit einem Menschen.
Signaturprüfung
Jede eingehende Anfrage wird mit dem konfigurierten Signing Secret gegen den Stripe-Signature Header geprüft: HMAC-SHA256-Verifikation, Timestamp-Validierung gegen Replay Events und Rate Limiting. Ungültige Signaturen werden abgelehnt, und ohne ein konfiguriertes Secret mit dem Prefix whsec_ verarbeitet die Verbindung nichts. Ein ungeprüftes Event erreicht den Agenten daher nie.
Jedes verifizierte Event wird zu einem normalen Agent Run mit vollständigen Traces, Token- und Kosten-Tracking sowie denselben Guardrails und Approval-Regeln wie jeder andere Trigger. Das ist wichtig, wenn der nächste Schritt die Abrechnung eines Kunden betrifft.
Event-Auswahl und Payload
Welche Events den Agenten erreichen, wird im Stripe Endpoint festgelegt. Der Agent erhält das vollständige Stripe Event-Objekt mit dem Feld type und dem zugehörigen data.object. Ein payment_intent.payment_failed Event enthält last_payment_error samt Decline Code; ein Subscription Event enthält Plan und Status. Der Agent liest diese Felder direkt und muss nicht erst die Stripe API erneut abfragen. Stripe-Dokumentation: Payloads und Beispiel-Agent.
Informationen
- Publisher
- Von Connic
- Verbindungen
- Verbindungen
- Modi
- Inbound
- Dokumentation
- Stripe Docs
Häufig gestellte Fragen
payment_intent.payment_failed ausgewählt. Bei einer fehlgeschlagenen Zahlung erhält der Agent das vollständige Event inklusive Decline Code und Customer ID und kann mit einer passenden Retry-E-Mail, Support-Eskalation oder internen Benachrichtigung reagieren.Stripe-Signature Header mit dem konfigurierten Signing Secret per HMAC-SHA256, validiert Timestamps gegen Replay-Angriffe und lehnt ungültige Signaturen ab. Das whsec_ Secret wird einmal beim Setup eingefügt; zusätzlicher Prüfcode entfällt.Beschreibe die Event-Quelle, die Struktur der Payload, das Ziel für die Ergebnisse und die Anforderungen an private Netzwerke oder Freigaben. Wir helfen, Stripe mit dem passenden Verbindungsmodus, Deployment und Monitoring in Connic einzurichten.
Sprich mit SalesWeitere Verbindungen
Entdecke den MarketplaceApache Kafka
Topics konsumieren und Ergebnisse veröffentlichen
AWS SQS
Eine Queue mit einem Agenten abarbeiten
PostgreSQL
Per LISTEN/NOTIFY auf neue Zeilen reagieren
HTTP-Webhooks
Agenten bei jeder HTTP-Anfrage ausführen
WebSocket
Tokens über einen Live Socket streamen
E-Mail (SMTP/IMAP)
Postfächer lesen und Antworten senden