subscription-billing

Implements recurring subscription billing with dunning, prorations, and cancellation across ecommerce platforms.

3|1|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/tomtoto757/ecomm-ai-team --skill subscription-billing-tomtoto757
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: subscription-billing
Source: https://github.com/tomtoto757/ecomm-ai-team/tree/main/skills/checkout-payments-tax/finsilabs/payments-checkout/subscription-billing
Command: npx skills add https://github.com/tomtoto757/ecomm-ai-team --skill subscription-billing-tomtoto757

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires stripe.

What problem does it solve? Setting up recurring billing involves many failure-prone details: failed payment recovery, plan change prorations, trial handling, and cancellation flows. This Skill provides platform-specific guidance and production-ready Stripe patterns so subscriptions are billed, retried, and cancelled correctly without building billing logic from scratch. ## Core Features & Use Cases - Platform Setup Guidance: Step-by-step configuration for Shopify Subscriptions, Recharge, WooCommerce Subscriptions, BigCommerce with Recurly, and headless Stripe Subscriptions. - Stripe Implementation Patterns: Code for subscription creation with trials, webhook-based status sync, plan changes with proration previews, and end-of-period cancellation. - Dunning and Churn Recovery: Escalating failed-payment email sequences, Smart Retries configuration, and idempotency guards against duplicate dunning emails. - Use Case: A SaaS company losing revenue to involuntary churn uses this Skill to implement an invoice.payment_failed webhook handler that sends escalating recovery emails without duplicates, plus a cancellation endpoint that preserves access until period end. ## Quick Start Use the subscription-billing skill to create a Stripe subscription endpoint with a 14-day trial, webhook status sync, and prorated plan upgrades.

Frequently Asked Questions about subscription-billing

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

FAQPage Schema
How do I set up subscription billing on Shopify?▼

Shopify subscription billing can use the free built-in Shopify Subscriptions app for basic recurring orders, or Recharge for advanced dunning, analytics, and customer portals. Configure billing frequency, subscriber discounts, and trials under each product's purchase options.

How to handle failed subscription payments with Stripe dunning?▼

Stripe dunning uses Smart Retries enabled under Billing Settings, which applies ML-based retry timing. Send escalating emails on each invoice.payment_failed webhook, keyed by attempt_count, and guard against duplicates using the invoice ID plus attempt count as an idempotency key.

How do I prorate subscription plan upgrades and downgrades in Stripe?▼

Stripe proration uses proration_behavior: 'create_prorations' on stripe.subscriptions.update to charge upgrades immediately. Preview the cost first with stripe.invoices.retrieveUpcoming, and schedule downgrades at period end to avoid partial refunds.

Does WooCommerce Subscriptions retry failed recurring payments?▼

WooCommerce Subscriptions retries failed payments only when the gateway supports tokenized recurring payments, such as Stripe via the WooCommerce Stripe plugin. Basic PayPal Standard does not support automatic retries.

Why does a subscription show active after cancellation?▼

This happens when subscription state is not synced from Stripe to your database. Handle the customer.subscription.deleted webhook to update local status and revoke access instead of polling Stripe on every page load.

When should I use Stripe Subscriptions instead of a platform app?▼

Stripe Subscriptions fits custom or headless storefronts where you control checkout via API. For Shopify or WooCommerce, native apps like Recharge or WooCommerce Subscriptions handle edge cases like tax changes and prorations without custom billing code.