Stripe Payment Failed — Webhook Template for Payments
Webhook
Stripe payment fails — AI looks up the customer, creates a priority ticket for enterprise accounts, and alerts billing.
Template Stripe Payment Failed bundles a ready-to-deploy workspace for payments workflows.
Install in one click from the Aerostack dashboard or via aerostack init --template=stripe-payment-failed.
What It Does
Intelligent Stripe payment failure handling with customer context. When a payment fails, the AI does not just alert — it looks up the customer in your database, checks their plan tier and history, and triages accordingly. Enterprise customers and high-value failures get priority tickets. Everything gets logged.
How It Works
- Stripe fires a payment failure event
- Customer lookup — AI queries your database via Supabase MCP to find the customer's plan, history, and account status
- Triage — enterprise customers or amounts over $100 get a high-priority support ticket; others get standard logging
- Slack alert — billing team notified with customer context, failure reason, and recommended action
Example Scenario
An enterprise customer ($2,400/year) has a payment fail due to insufficient funds. The AI looks them up: "Acme Corp, Enterprise plan, customer since 2024, 2 previous failed payments." A high-priority ticket is created. Slack message includes: full history, failure pattern, and suggests "Reach out directly — this is their 3rd failure. Consider offering invoice billing."
Triggers
payment_intent.payment_failed— payment attempt declinedinvoice.payment_failed— subscription renewal failedcharge.failed— direct charge declined
psychology System Prompt
The instructions that define how this webhook behaves. It ships pre-configured — edit it anytime in your workspace.
You are a payment failure triage agent. When a Stripe payment failure event arrives, look up the customer in your database to determine their plan tier and payment history. For enterprise customers or amounts over $100, create a high-priority support ticket with full context. For all failures, post a notification to the billing Slack channel. Include: customer name, email, plan, amount, failure code, and recommended next steps.
checklist Setup Guide
When a payment fails: look up customer plan and history, create high-priority ticket for enterprise or amounts over 100 dollars, notify billing on Slack.
Metadata
What's Included
Required MCPs
MCP servers this template connects to.
Deploy this webhook in minutes
Stripe payment fails — AI looks up the customer, creates a priority ticket for enterprise accounts, and alerts billing.
Frequently asked questions
How does the Stripe Payment Failed webhook template differ from the Payment Failed Handler template? +
This payments-category webhook adds customer tier intelligence: it looks up the account in Supabase, creates a priority ticket for enterprise customers, and sends a graded Slack alert — standard accounts get a lower-urgency notification.
Which MCPs are wired into the Stripe Payment Failed template? +
@aerostack/mcp-stripe reads the charge event and customer record; @aerostack/mcp-supabase resolves account tier and history; @aerostack/mcp-slack delivers the prioritized alert to the billing team.
How do I define which accounts count as enterprise in the Stripe Payment Failed webhook? +
Set a Supabase query in the workspace config that identifies enterprise accounts — typically by plan name or MRR threshold. The agent uses the result to branch between standard and priority ticket flows.
What engineering effort is required to deploy the Stripe Payment Failed webhook template? +
Zero server setup. Register the Aerostack webhook URL in your Stripe dashboard, connect the three MCPs, and the priority-triage flow is live. No infrastructure to provision or maintain.