> ## Documentation Index
> Fetch the complete documentation index at: https://www.carstoragesoftware.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Handle declined recurring payments

> What happens when a plan's card is declined, how to collect the unpaid invoice, and how to keep Stripe from cancelling the plan.

When a recurring charge fails, the invoice stays open and the plan goes **Past Due**. Your job is to get a working payment method and collect the open invoice. Set Stripe up once (below) so plans keep billing instead of being cancelled.

## What you'll see

* **An alert on the first decline.** Staff with Payments access get an in-app notification, email, and push: "Card declined for *customer*: *amount* due *date*. Ask them for a new card". It's one alert per invoice, not one per retry. Turn it on or off in your notification settings under **Recurring Payment Declined or Plan Canceled for Non-payment**.
* **Past due badges.** The plan shows **Past Due** on the Recurring list. The invoice shows **Past due · declined** on the invoice list, and the payment attempt reads **Declined**. Declined amounts count toward **Past Due** on the [Payments overview](https://www.carstoragesoftware.com/docs/payments/use-the-payments-overview-dashboard.md).

## Collect the unpaid invoice

**1. Get a new payment method**

Open the plan and click the method tile on the **Payment method** card. Choose **Request** to email the customer a link, or **On file** to add a card yourself.

**2. Charge the open invoice**

Open the unpaid invoice from the plan's **Billing history**. Choose **Charge payment method on file** from **Actions** and pick the new card. You can also **Remind customer** so they pay from the invoice link, or record cash with **Mark as paid**.

Stripe also retries the card on its own schedule. There's no separate retry button.

## Keep Stripe from cancelling the plan

By default Stripe may cancel a subscription after its last retry. Change that once in your Stripe account:

**1. Open Stripe's retry settings**

In your Stripe Dashboard, go to **Billing → Revenue recovery → Retries**. Make sure you're in your live account.

**2. Set what happens when all retries fail**

Under **If all retries for a payment fail**, choose **Leave the subscription past-due**. Keep **Leave the invoice past-due** for the invoice so the debt stays visible. Click **Save**.

## If Stripe cancels the plan anyway

[Settings → Billing](https://www.carstoragesoftware.com/dashboard/settings/billing) has **Restart recurring plans automatically when Stripe cancels for non-payment**. It's **On** by default.

When Stripe cancels a plan for non-payment and a vehicle on it is still in your care (in storage or at a vendor you sent it to), the app can create a replacement plan. Some plans are skipped. The replacement first bills on the old plan's next billing date. Nothing is charged twice, and the unpaid invoice stays open for you to collect. You get an alert saying the plan was cancelled and whether it was restarted; if it wasn't, the alert says why (for example, the plan has several line items or the customer already has another active plan for the same product). **How many times one plan can restart** limits repeat restarts.

Plans are left cancelled when no vehicle on them is in your care, when they have several line items, when they were already scheduled to end, or when you turn the setting **Off**. These show as **Cancelled · card declined** on the Recurring list. Once you have a new card, [set the plan up again](https://www.carstoragesoftware.com/docs/payments/set-up-recurring-billing.md).

## Related

* [Collect a payment](https://www.carstoragesoftware.com/docs/payments/collect-a-payment.md)
* [Change a recurring plan](https://www.carstoragesoftware.com/docs/payments/change-a-recurring-plan.md)
* [Manage your profile and alerts](https://www.carstoragesoftware.com/docs/settings/manage-your-profile-and-alerts.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.