> ## 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.

# Keep recurring billing going after a declined card

> Set Stripe so a declined card leaves a recurring plan past due instead of canceling it, and know what to do when a charge fails.

When a customer's card is declined on a recurring charge, Stripe retries it for a while. What happens after the last retry fails is decided by a setting in **your own Stripe account**. Stripe's default is **Cancel the subscription**, which quietly stops all future invoices for that customer. This guide shows how to change it so invoices keep coming, and what Car Storage Software does when a charge fails.

## What you will accomplish

* Your Stripe account leaves a plan **past due** after failed retries instead of canceling it, so the customer keeps getting invoiced every billing period.
* You know where declined charges show up and what to do about them.

## Before you start

* You need to be able to sign in to your facility's Stripe account (the one connected under [Settings → Billing](https://www.carstoragesoftware.com/dashboard/settings/billing)) with a role that can change Billing settings (Administrator).
* Car Storage Software can't change this setting for you. It belongs to your Stripe account.

## Steps

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

In your Stripe Dashboard, go to **Billing → Revenue recovery → Retries** ([dashboard.stripe.com/revenue\_recovery/retries](https://dashboard.stripe.com/revenue_recovery/retries)). Make sure you're in the live account, not a test (sandbox) account.

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

Find **Subscription status** → **If all retries for a payment fail**. Choose **Leave the subscription past-due**.

| Option | What happens | Recommended |
| - | - | - |
| Cancel the subscription | The plan ends. No more invoices. | No |
| Mark the subscription as unpaid | Invoices keep being created but stay as drafts and aren't charged. | No |
| **Leave the subscription past-due** | Invoices keep being created and charged on schedule. | **Yes** |
| Pause the subscription | No invoices until the plan is resumed. | No |

If you use Stripe **Automations** for retries, check each automation's final action too.

**3. Leave invoice status as-is**

On the same page, under **Invoice status** for failed payments, keep **Leave the invoice past-due** so the unpaid invoice stays open and shows as past due in Car Storage Software. Marking it uncollectible hides the debt.

**4. Save**

Click **Save**. The change applies to retries from now on.

**Expected result:** The next time a card fails all its retries, the plan shows **Past Due** in [Recurring billing](https://www.carstoragesoftware.com/dashboard/payments/recurring) and next period's invoice is still created.

## What Car Storage Software does when a recurring charge fails

* **You're told right away.** Staff who can see Payments get an in-app notification, an email and a push notification: "Card declined for *customer*: *amount* due *date*. Ask them for a new card", with a link to the customer and how many invoices are open on the plan and for the customer. It goes out on the first declined payment. You get one alert per invoice, not one per retry. Turn it on or off under your notification settings (**Recurring Payment Declined or Plan Canceled for Non-payment**).
* **Past dues are easy to see.** Declined charges count toward **Past Due** on the [Payments overview](https://www.carstoragesoftware.com/dashboard/payments), show a **Past due · declined** badge in [Invoices](https://www.carstoragesoftware.com/dashboard/payments/invoices), and put a red **Past due** badge at the top of the customer's contact page.
* **If Stripe still cancels the plan** (because the setting above is still on Cancel) and a vehicle on the plan is in your care (in storage, or at a vendor you sent it to), Car Storage Software starts a replacement plan on the same price and billing day. This happens every time Stripe cancels it while a vehicle is in your care. The first new invoice is the **next** billing date, so nothing already invoiced is charged twice. The unpaid invoice stays open for you to collect. You get a louder alert saying the plan was canceled for non-payment and whether it was restarted. This is **on by default**; see below to turn it off.
* **Some plans aren't restarted automatically:** plans with no vehicle in your care (no vehicle on the plan is in a spot or zone, or at a vendor you sent it to; when no vehicle is linked to the plan, none of the customer's vehicles is), plans with several line items, plans that were already scheduled to end, plans whose next billing date had already passed, and every plan when you've turned the restart off. The alert says why. These show as **Cancelled · card declined** in Recurring billing (they stay in the default list for 60 days, and you can filter for them any time), so they don't silently drop out of your count. Once you have a new card, set the plan up again from the customer's billing section.

## Turn the automatic restart off

If you'd rather a plan stay canceled when Stripe cancels it for non-payment:

**1. Open Billing settings**

Go to [Settings → Billing](https://www.carstoragesoftware.com/dashboard/settings/billing#nonpayment-restart). You need the **Payments** permission (or full admin access).

**2. Choose Off**

Under **Restart recurring plans automatically when Stripe cancels for non-payment**, choose **Off**. It saves right away.

**Expected result:** The next time Stripe cancels a plan for non-payment, it stays canceled and no more invoices go out. Billing staff still get the alert, and it says the plan wasn't restarted because the restart is turned off.

Choose **On** again at any time. It applies to cancellations from then on; plans that stayed canceled while it was off need to be set up again by hand.

> [!TIP]
>
> After the customer gives you a new card, add it as their default payment method. Stripe retries open invoices with the new card, and future invoices use it.

## Troubleshooting

> **My recurring plan count dropped and I didn't cancel anything**
>
> Filter [Recurring billing](https://www.carstoragesoftware.com/dashboard/payments/recurring) by **Cancelled · card declined**. Those plans were canceled by Stripe after failed retries. Then change the Stripe setting above so it doesn't happen again.

> **A customer was restarted but I don't want to keep billing them**
>
> Cancel the new plan from Recurring billing like any other plan. The old unpaid invoice stays open until you void it or it's paid.


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