Docs
You can configure taxes for all taxable regions in your Chargebee site manually. Following are some of the salient features of tax configuration in Chargebee:
To ensure taxes are correctly applied to invoices, make sure you've configured taxes in Chargebee for each region where your customers are located.
The following setting is a prerequisite that needs to be added before you configure taxes in your Chargebee site:
Organization Address: Providing your business' address is a mandatory step for configuring taxes in Chargebee. You cannot enable taxes in your Chargebee site without providing an organization address. Chargebee requires this information to calculate your tax liability.
To add your organization address in Chargebee, click Settings > Configure Chargebee > Business Profile > Add Address.
To configure taxes in your Chargebee site, follow these steps:
Click Settings > Configure Chargebee > Taxes > Configure Tax. Click Add Address to add your organization address if you haven't added it already.
Price type determines whether taxes are inclusive or exclusive with your product price. The price that you quote for your product or service in Chargebee can be either:
You might be selling in one currency or many. You can customize the price type for each one. You can configure price type configurations at the following two levels:
Here is an example of how Price Types work:
| Product name | Unit Price | Currency | Price Type | Sample Tax Rate |
|---|---|---|---|---|
| Basic Plan_usd | 100 | USD | Exclusive | 5% |
| Professional Plan_usd | 150 | USD | Exclusive | 5% |
In this case, both the basic and professional plans are priced at 100 and 150 USD respectively. The price type 'exclusive' indicates that a 5% tax rate will be added to this price on the invoice.
| Product name | Unit Price | Currency | Price Type | Sample Tax Rate |
|---|---|---|---|---|
| Basic Plan_eur | 80 | GBP | Inclusive | 20% |
| Professional Plan_eur | 120 | EUR | Inclusive | 20% |
In this case, both the basic and professional plans are priced at 80 GBP and 120 EUR respectively. The price type 'inclusive' indicates that this price will include a 20% tax rate on the invoice.
| Tax Exclusive | Tax inclusive |
|---|---|
| If you set the Price Type to Tax Exclusive, the tax will be calculated on the charge and added to the charge to arrive at the total payable amount. Total Charge - $100 Tax applicable is 5%. In this case, $5 Total amount is $105 (100+5). |
If you set the Price Type to Tax Inclusive, the tax you configure will be included as part of the charge. The tax amount will be derived from the charge. That is, the tax amount will be derived from the total charge and displayed on the invoice. When discounts are not applied Total Charge - £100 Tax included is 20%. The tax break-up will be: Unit Price - £83.33 Tax - £16.67 Total amount stays at £100 When a discount is applied Total Charge - $155 Discount applied - $50 Taxable amount - $105 Tax applied is 5%. In this case, $5 The tax break-up will be: Charge - $100 Tax - $5 |
The prices of your plans and addons in Chargebee are set to tax-exclusive by default. You can customize the price type for each currency that you have added to your Chargebee site. You can edit this setting by following these steps:
In the Review Catalog Price Type page, select a currency to update the price type.
Select your preferred price type settings. When you select My prices are inclusive of the tax, you can optionally enable consistent pricing. Click here to read more about consistent pricing.
Once you are done, click Update and click I've reviewed the price types.
You can change the price type for your currencies at any time using the Manage Catalog Price Types link on the Configure Tax page.
If a customer is enabled for tax exemption, the tax amount will be deducted from the total charge while invoicing. Discounts, if any, are applied before the tax is added. Refer to the Customers page to see how to exempt a customer from tax payment.
If the product/addon is marked as exempted from tax, the charge provided will be treated as exclusive of tax. Discounts, if any, will be applied on this amount. Refer to the Plans page to see how to mark a plan as non taxable.
If you have a global customer base and would want to charge all the customers the same price, you can make use of the Consistent Pricing option. This option allows you to have a flat-rate charge for your product or service, regardless of the taxes applicable and the customer's country/region.
To enable consistent pricing options, follow these steps:
In the Configure Tax page, click Manage Catalog Price type.
Select the currency and choose My prices are inclusive of the tax.
In the Tax included is that of drop-down, select the country of which the tax is to be included for the currency.
Enable the setting to display consistent checkout prices for all regions. You can optionally select the following settings as required:
Third Party Integrations: When you have integrated your Chargebee site with Avalara for automated tax calculation, you can enable this setting to display consistent catalog prices in regions for which Avalara is configured. While a consistent rate is charged for your product or service, Avalara calculates the tax included from the catalog price for these regions.
If you are using Chargebee's tax for all the regions, or if you have configured Avalara for tax automation in all your taxable regions, you do not have to select a country under Tax included is that of option.
However, if you have some regions for which you manage taxes manually or via CSV, make sure that you select an appropriate country of which the tax is included for the currency. This is to ensure that the country whose tax is included is accounted for correctly while computing the catalog price. In the absence of configured country-level taxes, Chargebee defaults to an origin tax rate of 0%.
Click Update.
Chargebee's pricing flexibility is evolving to meet the diverse needs of merchants worldwide. Previously, Chargebee allowed the price type configuration at the site level for each currency. However, we're introducing enhanced flexibility in price type configuration for subscriptions. Whether you're selling to B2B and B2C customers with varying tax preferences or transitioning between tax-inclusive and tax-exclusive pricing models, Chargebee now offers the flexibility you need to optimize your subscription pricing.
Setting Up Price Type Configurations via the Chargebee App
To set up price type configuration in Chargebee, you can now utilize the newly introduced Price Type field within the customer details page. This field allows you to specify the price type for individual customers based on their pricing preferences. When populating the field, you should ensure that the values are entered exactly as follows: "tax_inclusive" for customers who prefer inclusive pricing, or "tax_exclusive" for those who prefer exclusive pricing.
Setting Up Price Type Configurations via the Chargebee API
To set up price type configurations via the Chargebee API, you can leverage the Create a Customer API or Update a Customer API. Specifically, you can utilize the following fields:
tax_providers_fields[provider_name][0]
Value = all
tax_providers_fields[field_id][0]
Value = priceType
tax_providers_fields[field_value][0]
Value = tax_inclusive or tax_exclusive (case insensitive)
To enable this feature, kindly contact support . You can access the same fields available in the Chargebee dashboard on the customer creation/edit page under tax details.
The price type configuration is designed for calculation purposes only; the representation on the invoice will continue to be based on the configuration at the regional level. For inclusive price types, the total amount will remain consistent regardless of tax rates. For instance, if a plan is priced at $100 with a tax-inclusive price type, the total amount payable by the customer will be $100, irrespective of whether the tax rate is 10% or 20%. Even if the customer is eligible for reverse charges, the payable amount will still be $100, with the invoice tagged accordingly.
The price type configuration if available at the customer level will take priority over the price type setup at the currency level for the customer
You can start adding regions where you have registered and are liable to collect tax. To add taxable regions to your Chargebee site, follow these steps:
In the Configure Taxes page, click Add Region and select the country from the drop-down list.
Pick your preferred mode of tax configuration for the region. You can select from the following:
Click Add Tax to add multiple tax components for this region as required. Once, the rates are provided, Chargebee will show you a summary of the rates you have configured and provide the options edit, or delete the tax rates, if the need arises.
For each country being added, you can optionally click Add Tax reg no. to provide the Tax Registration number as part of the configuration.
Choose your preferred label to be displayed in your Invoices, specify your tax registration number and click Save.
You can enable/disable Tax Registration Number to be captured from your customers from this region.
Additionally, you can choose to enable/disable the Tax Registration Number from customers for countries not configured for tax. If a country-specific setting is set up, it will take the highest precedence. For other countries not configured in the Tax Jurisdiction list, Chargebee displays Tax Registration number or the label you have provided in Text configuration settings for Hosted pages.
Once you have saved your settings for this region, you can go back to the Configure Tax page, and add more regions for tax configuration.
Via API
You can send the VAT Number via the vat_number field via the following APIs:
Price type regulations differ from country to country. Some countries, like the US, allow you to set your prices as inclusive or exclusive of tax as you see fit. Others, like New Zealand or Australia, require your invoices to display a price specifically inclusive or exclusive of taxes.
With Chargebee, you can plan for a scenario like this - you can set your prices to be tax inclusive in some regions and tax-exclusive in others. If you are selling in a particular currency to customers around the world, you can set your price in that currency to be either tax inclusive or exclusive. Additionally, if some of the countries you are selling in have regulations that call for a particular price type, you can set your price in that country to be either tax inclusive or tax exclusive.
You are based in the EU region, selling digital goods at a price of €100 per month. Your origin country is Belgium with tax configured at 21%. You are selling in the EUR Currency that is configured to be Tax Inclusive, and the origin EU region is set to be Tax Exclusive.
The shipping address of a customer is in France and the end customer is not a business, and therefore does not have a VAT number. The tax rate for this customer's invoice is calculated as follows:
France tax rate = 24%
Since the currency is inclusive, the €100 price of the plan is inclusive of taxes.
Actual price of the plan = €100/1.2 = €83.33
Since the region prices are exclusive of tax, a tax rate of 24% for France region gets applied to the actual price of the plan, €83.33.
Invoice total = €83.33*1.24 = €103.33
€83.33 = subtotal
€20 = Taxes
To configure region-specific price type for your checkout prices, navigate to Configure Taxes > Select region > click Manage in Your Checkout Prices section.
How to configure:
US Sales Tax
Canada Sales Tax
EU VAT
New Zealand GST
Tax in Other countries
After configuring taxes and adding price types for your catalog prices, all the plans and addons in your Chargebee site become taxable. You can change this default setting for a specific plan/addon based on your requirements and tax compliance. You can update the taxability of your plans and addons in the following ways:
Via Chargebee Site: While creating or editing a plan/addon, edit the This Plan/Addon is subject to taxes setting as shown in the below screenshot:
Via API: While creating/editing a plan, set the taxable parameter as false to mark a product 'non-taxable'.
The above step is applicable only if you are using the built-in Chargebee Billing taxation. If you're using any third-party tax providers like Avalara, this step is not required.
If you sell different products which are subject to different tax rates in the same taxable country, you can set up multiple tax profiles in Chargebee for each of the taxable items.
Chargebee saves all your tax settings under an initial profile called "Primary" profile.
If you are selling a single category of products and don't need to apply different tax rates, you can maintain this single ‘Primary' tax Profile, with the tax rates configured across the countries you are planning to sell.
However, if you are selling products across different categories (digital and physical goods for example), and require different tax rates to be applied to different products in the same country, you can create different tax profiles to cater to the different products/rates.
Let's assume you are running ABC Solar company and selling the following products in Europe and the UK:
To configure multiple tax profiles in your Chargebee site, follow these steps:
Click Settings > Configure Chargebee > Taxes > Configure Tax profile > Add Profile.
Specify a name to the new profile that you are creating and click Save.
Once the required tax profiles are added, you can view the profiles in all the taxable regions that you have added.
You can provide the tax rates for each profile, as required.
Once you have configured multiple tax profiles, go to the respective plans/addons and map them to their appropriate tax profile.
If you create only one profile, it will be automatically mapped to your product catalog. In case you have enabled more than one profile, the DEFAULT profile gets mapped to all products. You can edit the plan/addon price point to map a different profile and save it. Based on the associated tax profile settings, the tax rate will be applied for the subscription.
You can delete the tax profiles(except the primary/default profile) that you created in Chargebee at any point in time. But before deleting the tax profile, you need to unlink the profile from any plans/addons that they are associated with. Unless you unlink the profile from associated plans/addons, you will not be able to delete it.
To delete an existing tax profile, follow these steps:
When a tax profile is deleted, it gets removed from every associated taxable region/country. However, the tax rates that were applied on existing invoices are not affected/changed.
Contact support to enable this feature for your site.
Tax Amount Withheld or Tax Deducted as Source (TDS) is a direct taxation mechanism that was introduced to collect any applicable tax at the source of payment transactions, by the buyer. As per the Tax Amount Withheld, when a buyer(deductor) is liable to make a payment to the seller(deductee), the buyer deducts tax at the source and transfers the balance to the deductee. The buyer withholds a certain part of the total amount to be paid to the seller and pays it directly to the government as taxes.
Let's look at an example. Acme Inc makes a payment of USD 20,000 towards professional fees to ABC Corp. and the applicable tax rate is 10%. Acme withholds the tax of USD 2,000 and makes a net payment of USD 18,000 to ABC Corp. Acme Inc. directly deposits the amount of USD 2,000 to the credit of the government.
Based on your business requirements and tax compliance rules in your country, you can record taxes withheld in Chargebee by specifying the amount withheld, for offline payments.
Roles and Restrictions
To allow recording the tax amount withheld in your Chargebee site, follow these steps:
Click Settings > Configure Chargebee > Taxes.
Enable the setting Record Tax Amount Withheld by Customers for offline payments.
Click Save.
After the setting is enabled, users can start recording the tax amount withheld for all offline payments on your Chargebee site.
When the setting to allow recording tax amount withheld is disabled, users will not be able to record the taxes withheld for any invoices (generated before/after disabling) going forward. Users can remove an existing tax withheld line item from an invoice record, however, users cannot add the tax amount withheld again, even for the same invoice.
To record the tax amount withheld for an invoice, follow these steps:
Click Customers/Subscriptions and select the customer/subscription record for which you are recording TDS.
Click open the associated Payment Due/Not Paid invoice.
Click the more icon, select Record Tax Amount Withheld and specify the amount. You can specify an amount that is equal to or lesser than the amount that is due as per the invoice, at the time of recording the TDS.
Optionally, edit the note that gets displayed for the amount withheld on the respective invoice PDF.
Click Proceed.
The tax amount withheld is successfully recorded for the invoice.
You cannot modify the tax amount withheld for the invoice. However, you can remove the amount withheld item and add it again as required.
The invoice PDF displays a note on the tax withheld.
You can create credit notes from invoices with tax amounts withheld.
While creating refundable credit notes or refunds for an invoice that contains taxes withheld, the amount specified for credit cannot exceed the sum of the invoice amount, taxes withheld, and credits from any previous credit notes.
Reverse charge is a tax mechanism where the liability to pay taxes falls upon your customer - the buyer of your products or services, and not on you - the supplier. The reverse charge mechanism is applicable in various countries and based on your requirements, you can configure to collect reverse charges from customers in specific countries.
Chargebee applies the reverse charge mechanism only when:
To apply reverse charge for customers of specific countries in your Chargebee site, follow these steps:
Click Settings > Configure Chargebee > Taxes.
On the Configure Taxes page, click Add Region and select the country from the drop-down list.
Enable the setting Reverse Charge.
You can also enable the setting to Show note on reverse charge to display a note on invoices when reverse charge is applied. The Reverse charge note is a common feature applicable for both Chargebee taxes and third-party taxes.
Click Edit Note to modify the default note message for reverse charge.
On the Edit Reverse Charge Note popup, type your new message and click Update.
You have successfully enabled the setting to apply reverse charges for the country.
When a subscription is created for a customer from a different country than your organization address for which you have configured to collect reverse charge, tax is not applied on the invoice, and the Reverse Charge note gets displayed.
If a customer's country is not in the Tax Jurisdiction list that is configured in your Chargebee site, you can still collect their Tax Registration number via UI, API, or a checkout field.
To enable this setting, click Settings > Configure Chargebee > Billing LogIQ > Billing & Invoices > Collect Tax Registration Number from customers for countries not configured for tax > and enable the setting.
EU and New Zealand - If you are selling physical goods, Chargebee will consider Shipping Address Country for tax calculation. If Shipping Address is not present, then Billing Address Country will be considered.
If you are selling Digital products/services, Chargebee will consider only Billing Address Country for tax calculation.
For rest of the countries, Chargebee considers Shipping Address Country and then Billing Address'.
No, you don't need to create multiple Tax Profiles. Chargebee will create a First Profile (named ‘Primary') automatically.
You will! If you are selling different products in the same/multiple countries at different rates, the Tax Profiles feature will help you setup different profiles for each product/region, so you can apply different tax rates with ease.
At the moment, you can only map one product to one profile (either digital or physical). If you are selling the same product in digital and physical format, you will have to create two different products in Chargebee so you can map them to two different profiles.
If you make any changes to your tax configuration it will affect all the invoices that are created from that point onward. Your past invoices will not be modified to reflect the changes that you make to your tax configuration - this includes deleting a region.
Articles & FAQ