Overview
Aikeedo v4.0 introduces a core tax infrastructure layer that enables tax calculation on purchases made through your platform. A tax engine is a plugin that calculates the tax amount on each order based on the customer’s billing address and the configured rules or connected tax service. You can install multiple tax engine plugins and switch between them at any time from your billing settings. Only one engine is active at a time, but all installed engines remain configured and ready to use.Available tax engine plugins
Manual Tax Engine
Define flat and percentage tax rates manually by country and subdivision. Full control, no external services required.
Stripe Tax
Automatic tax calculation via the Stripe Tax Calculations API. Requires Stripe to be configured as your payment gateway.
Selecting the active tax engine
Installing a tax engine plugin does not activate it automatically. You select the active engine from your billing configuration:- Navigate to Settings > Billing in your admin panel.
- Under the Tax section, open the Tax engine dropdown.
- Select the engine you want to use, or choose No tax to disable tax calculation entirely.
- Click Save changes.
Tax base
In Settings > Billing > Tax, you can also set the Tax base — the amount that tax is calculated against:| Option | Description |
|---|---|
| Net after coupon | Tax is calculated on the discounted amount after any coupon is applied. If no coupon applies, the full plan list price is used as the base. |
| Full plan list price | Tax is always calculated on the full plan price, regardless of any discounts. |
Stripe Automatic Tax Collection
If you use Stripe as your payment gateway with the Hosted Checkout form type, there is an additional option that does not require a tax engine plugin: Stripe Automatic Tax Collection. With this feature enabled, Stripe handles both tax calculation and collection end-to-end within its hosted checkout flow. This only applies to payments processed through Stripe — other payment gateways are unaffected. It is also distinct from the Stripe Tax Engine plugin, which calculates tax for non-hosted Stripe checkout flows.How tax is applied
- A customer proceeds to checkout with a billing address on file.
- Aikeedo calls the active tax engine with the order amount and billing address.
- The tax engine returns one or more tax lines (name, rate, amount).
- The tax lines are displayed to the customer and included in the total.
- The payment gateway collects the full amount, including tax.
Tax is calculated based on the customer’s workspace billing address.
Customers must have a billing address on file for tax to be applied. If no
address is present, no tax is charged.
Need Help?
If you need assistance with Aikeedo:Professional Support
Get expert help from our team with a paid support subscription
Troubleshooting Guide
Check common issues and solutions