# Billing Dunning States

Handling failed charges and the grace period in SaaS subscriptions.

- id: `billing-dunning-states`
- Page: https://agentic-ui-kit.com/components/billing-dunning-states
- Live preview: https://agentic-ui-kit.com/live/component/billing-dunning-states

## Install

```bash
agentic-ui add billing-dunning-states
npx shadcn@4.17.0 add @agentic-ui/billing-dunning-states
```

## Metadata

- **Level:** feature
- **Category:** feature
- **Installable in:** Radix UI (registry variant new-york)
- **Capabilities:** past-due-state, grace-period-state, suspended-state, empty-state, payment-retry, payment-method-update, timeline-retry-history, invoice-breakdown, keyboard-navigation
- **Intents:** track-status, execute-flow
- **Suits domains:** billing, saas, ecommerce, fintech
- **Interaction:** dialog-toggle, keyboard-navigation, cta-selection
- **Screen role:** flow
- **Density:** medium
- **Dark mode:** yes
- **Use it for:** handling failed charges and the grace period in SaaS subscriptions, notification of suspension for non-payment with immediate reactivation, panel for resolving overdue invoices and updating the payment method
- **Avoid when:** initial checkout or first purchase screens (use billing-checkout-flow), comparative selection of commercial plans (use billing-pricing-table)
- **Preserve when adapting:** dunning-state-progression, accessible-alert-announcements, modal-card-input-validation
- **Replace when adapting:** domain-copy, currency-formatting, branding-and-support-links
- **Adaptation effort:** low
- **Coupling:** low
- **Quality score:** 9.2/10
- **Quality breakdown:** visual 9/10, responsive 9/10, accessibility 9/10, code 9/10
- **Uses primitives:** alert, badge, button, card, dialog, input, label, progress, tabs
- **npm dependencies:** lucide-react
- **Motion:** profile subtle, library css, reduced-motion fallback yes
- **npm dependencies (registry):** lucide-react@0.577.0
- **Registry dependencies:** lib-primitives