payment-failure-recovery

Configure retries, dunning emails, and grace periods for failed SaaS subscription payments.

Updated Mar 29, 2026
One-click install
npx skills add https://github.com/marquesfelip/agents-and-skills --skill payment-failure-recovery
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: payment-failure-recovery
Source: https://github.com/marquesfelip/agents-and-skills/tree/main/skills/payment-failure-recovery
Command: npx skills add https://github.com/marquesfelip/agents-and-skills --skill payment-failure-recovery

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Design and implement dunning flows for failed subscription payments, configure Stripe Smart Retries or custom retry schedules, and preserve customer access during grace periods while collecting metrics to optimize recovery rates.

Core Features & Use Cases

  • Automated dunning flow design and email sequencing across failure stages (first failure, retry, final warning)
  • Option A: Stripe Smart Retries (recommended); Option B: Custom retry schedule
  • Self-service payment method updates via Stripe Customer Portal or Setup Intent
  • Webhook handling for invoice.paid and invoice.payment_failed with appropriate state transitions
  • Telemetry and metrics to optimize recovery and reduce involuntary churn

Quick Start

Configure a dunning strategy and test a failed payment to validate the recovery workflow.

Frequently Asked Questions about payment-failure-recovery

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate dunning emails and retries for failed Stripe subscription payments?

Automated dunning for failed Stripe subscription payments configures retry schedules, sequences failure stage emails, and handles invoice.payment_failed webhooks to recover revenue. You can use Stripe Smart Retries or define a custom retry schedule to optimize the recovery workflow.

How does webhook handling work for failed payment recovery?

Webhook handling for failed payment recovery processes invoice.paid and invoice.payment_failed events to trigger state transitions in your database. It automatically initiates dunning emails, updates failure tracking records, and halts retries when a payment succeeds.

Can I let customers update their payment method themselves after a failed subscription charge?

Customers can update their payment method themselves after a failed subscription charge using the Stripe Customer Portal or Setup Intent flows. This self-service approach securely collects new details and automatically retries the failed invoice.

What's the best way to reduce involuntary churn from failed payments in SaaS?

Reducing involuntary churn from failed payments requires configuring grace periods that preserve customer access while automated dunning sequences attempt collection. Tracking recovery metrics and telemetry across retry stages helps optimize the strategy and recover more accounts.

Should I use Stripe Smart Retries or a custom retry schedule for dunning?

Stripe Smart Retries is recommended for dunning because it uses machine learning to optimize retry timing automatically. A custom retry schedule is available if you need strict control over retry intervals and specific failure stage email sequencing.

Do I need to track database state for failed subscription payments?

You need to track database state for failed subscription payments to manage dunning workflows accurately. State tracking records failure events, monitors grace periods, and ensures correct transitions when webhooks confirm invoice.paid or invoice.payment_failed statuses.