1. Home
  2. Functionality
  3. How to Create Installment Plans

How to Create Installment Plans

If available in your country, an alternative to creating installment plans is adding a buy now, pay later payment method to your checkout. See our Klarna and Afterpay/Clearpay docs to see if either are available in your country.

Installment plans (aka “max charges” or “payment plans”) allow you to have subscriptions that end after a specific number of charges. When the last charge is reached for a customer’s subscription, it is canceled and charges stop. No need for you to manually cancel subscriptions in your Stripe dashboard at a specific time for each customer.

There are 2 different methods you can use to add max charges to your subscription depending on what type of subscription options you are using.

A Professional or higher license is required to access enhanced subscription features.


You can use the new Invoice Limit option to set the maximum number of charges for subscriptions. This field will also be the value used for any custom amount plans that need to use installments.

Plans with a Free Trial

You can also set installments for plans that have a free trial attached to them. The only difference is that the first charge that counts towards the max charge count will be when the first actual charge takes place after the free trial ends.

Optional Subscription Toggle

There is an Invoice Limit setting when you check the optional subscription toggle. Here you can set the max number of charges for optional subscriptions.

NOTE: If you are only creating new installment plans, you are finished. The information below is for viewing, editing changing, existing subscriptions.

Viewing Installment Plans in Stripe

To monitor subscriptions with installment plans enabled, head to Subscriptions in your Stripe dashboard. See Viewing Subscription Details in Stripe if you’re unfamiliar with this section.

Select the subscription that should have installment plans enabled.

In the Metadata section, you should see 2 metadata labels with values related to installment plans. simpay_charge_count is the total number of times the user has been charged already at this point. simpay_charge_max is the total number of charges the installment plan is set to charge for. Once these two numbers are equal, the subscription will automatically be canceled.

Can I modify the max charges for a certain user?

Yes, you can! First, select the specific subscription you want to change. There is a tiny edit button above the metadata box that you can click.

Once in edit mode, you can update the value of any metadata entry. All you need to do is adjust the number to what you need and click Save.

Note of Caution

Changing the Invoice Limit will not affect existing subscription max charges – those need to be updated manually using the method mentioned above.

These values are not intended to be altered through your Stripe dashboard on a regular basis. It is something we consider to use more as an edge case and is highly recommended that you do not change these values unless very necessary. Proceed at your own risk.

If you are finding that you need to do this on a regular basis we would be happy to hear your situation and start an official feature request about it as it may be something we never thought of.

Finally, remember you can indicate to your customers how many times they’ll be charged on the payment confirmation page. Just use the {max-charges} template tag. See details at Configuring the Payment Confirmation Display.

Was this article helpful?

Still stuck? How can we help?
Updated on May 31, 2022