菜单
Use when handling failed Stripe payments: invoice.payment_failed, past_due subscriptions, dunning emails, grace periods, or billing recovery UX. Not for initial Checkout setup or webhook signature basics (use stripe-payment-webhooks).
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Use when reviewing or fixing accessibility: keyboard navigation, focus order, labels, color contrast, screen reader support, or ARIA attributes. Not for SEO-only or performance-only audits.
Use when adding product analytics (PostHog, GA4, Plausible), event tracking, funnels, or conversion measurement. Not for server logs only or A/B infra unless events are part of the task.
Use when standardizing API and edge function errors: HTTP status codes, error JSON shape, logging, or mapping Supabase/Stripe errors to client responses. Not for UI toast copy only or form field validation messages.
Use when recording audit trails: who changed what, admin action logs, compliance history, or append-only event tables. Not for product analytics (use analytics-events) or debug console logs only.
Use when scheduling background work: cron jobs, digest emails, cleanup tasks, pg_cron, Supabase scheduled edge functions, or job queues. Not for synchronous user-facing API in the request path.
Use when adding dark mode, theme toggle, system theme support, or fixing hardcoded colors that break in dark mode. Not for design-token migration unrelated to dark mode.
| name | payment-failed-and-recovery |
| description | Use when handling failed Stripe payments: invoice.payment_failed, past_due subscriptions, dunning emails, grace periods, or billing recovery UX. Not for initial Checkout setup or webhook signature basics (use stripe-payment-webhooks). |
Failed renewals are normal. Handle via webhooks + clear UX, not silent lockout.
| Event | Meaning |
|---|---|
invoice.payment_failed | Charge failed; subscription often → past_due |
customer.subscription.updated | Status may be past_due, unpaid |
invoice.paid | Recovery successful — restore active |
Handler: upsert subscriptions.status from Stripe object; never invent status client-side.
Document in code comments:
Strict — revoke pro immediately on past_due.
Grace — keep pro for N days while past_due; store grace_until on subscription row.
Default recommendation: 3–7 day grace + banner; full revoke when status canceled or unpaid.
past_due: "Payment failed — update card" → Customer Portal link.stripe.billingPortal.sessions.create({ customer, return_url }) from edge function or authenticated API.On invoice.payment_failed, invoke send-email edge function (email-and-notifications skill) with idempotency key event.id.
invoice.payment_failed.subscription.deleted or explicit cancel.invoice.payment_failed updates DB statusinvoice.paid restores access