Customize your invoice number

Starting with API version 2020-03-02, you can set how your invoice numbers are sequenced at the account level, which is required in some European countries.

How can I change how invoices are numbered?

You can go to your Settings then open the Invoices template page.

From there, you can switch from ‘customer’ to ‘account’ level or vice versa for your invoices, as demonstrated below.

Screen Shot 2020-02-24 at 5.15.54 PM.png

If you don’t see the option to edit your Invoice numbering in your Invoice template settings, it’s likely your account is using a default API version from prior to 2020-03-02. You can follow the guide in our docs to upgrade your API version, but we strongly discourage changing your API version without the help of a developer.

How can I set the prefix and sequence of the next invoice created?

Once you have switched from ‘customer’ to ‘account’ level for your next invoices in your Settings, you can modify the following:

Screen Shot 2020-02-24 at 5.16.00 PM.png

This way, you can ensure your next invoice with Stripe will follow your previous invoice number. This is particularly useful if you are migrating to Stripe.

What is the default invoicing level on my account?

The default behavior depends on the country that your Stripe account is based in.

In the EU and in the UK, account level prefixes are used by default for any account created after February 29th, 2020. In all other countries, customer level prefixes are the default.

If you modify the default behavior, it will only apply on new invoices; existing invoices will not be affected.

Does this make my invoices compliant?

You have the ability to be compliant with this feature, but ultimately it is your responsibility to ensure you are following the requirements of the legislation in your country. We have some region-specific guides on invoicing best practices below:

We cannot provide legal advice on whether your invoices are compliant or not. We advise you to seek legal help to confirm this.

Additional invoice customizations

For a complete overview of what you can edit on an Invoice, check out our Customize invoices docs.