Logo

Tax Calculation

OpenMeter automatically uses external services to calculate and add taxes to invoices.

Tax Services

Currently, OpenMeter supports the following tax calculation services:

Tax calculation fees

Tax calculation services charge separately from OpenMeter.

Automatic Tax Calculation

Tax settings are configured under the Billing Settings.

SettingDefaultDescription
enabledtrueEnable automatic tax calculation when a tax service is available.
enforcedfalseEnforce tax calculation when a tax service is available.

Enable Tax Calculation

Enable automatic tax calculation through installed apps. For example, with the Stripe app, the tax is handled by Stripe Tax.

Calculation Enforcement

When enforcement is enabled, OpenMeter prevents you from starting a subscription if automatic tax calculation isn't supported. When enforcement is enabled, the following actions are blocked:

  • Creating a paid subscription when tax cannot be calculated
  • Finalizing an invoice when tax cannot be calculated

Validation logic also varies by tax service. For example, with Stripe Tax, OpenMeter uses Stripe's APIs to verify whether tax calculation is supported for the customer. In that case of Stripe, the customer must have a valid tax location.

Calculation Not Enforced

If enforcement is disabled and tax cannot be calculated, invoices are created without taxes. This option is useful if you prioritize revenue collection over automatic tax calculation. When an invoice is created without taxes, you'll need to handle tax manually.

Tax Settings

OpenMeter supports the following tax settings:

  • Tax Inclusion: The price includes or excludes Tax.
  • Tax Code: The tax code to use for the item.

In OpenMeter, you can define the tax behavior on multiple levels, from lowest to highest precedence:

  • Payment Provider: Fallback to the tax behavior of the Payment Provider like Stripe
  • Billing Profile: Define the default tax behavior, if any, for all customers using the Billing Profile
  • Plan Rate Card: Override the default tax behavior on a per Rate Card basis
  • Subscription Rate Card: Override the default tax behavior on a per-subscription basis
  • Invoice: Override the tax behavior per invoice line item

We recommend setting the tax behavior on the Payment Provider level if you use Stripe for tax calculation. Tax behavior is optional at the billing profile, plan rate card, and subscription rate card levels.

In Product Catalog

OpenMeter lets you define tax codes and tax behavior per rate card. You can also set default tax behavior and tax codes in the Billing Settings.

Tax behavior can be:

  • Inclusive: The listed price already includes tax. A 10% inclusive tax on a $500 item still results in a $500 invoice.
  • Exclusive: Tax is added on top of the listed price. A 10% exclusive tax on a $500 item raises the invoice total to $550.

Some payment providers, like Stripe, apply their own default tax code. In those cases, you can leave OpenMeter's tax settings blank.

Last updated on