Charging the legally appropriate amount of tax on orders is especially tricky for online sales. The right percentage to charge—if any—depends upon the customer’s country or U.S. state, the types of products being purchased, and the order total. To help businesses dynamically calculate and apply accurate taxes in real-time, Stripe has partnered with Taxamo.
We’ve integrated the Taxamo tax calculation product directly into the Stripe Orders API. The Orders API allows users to represent their inventory and orders within Stripe, rather than on their own site or through a third-party. If you are not yet familiar with the Orders API, we recommend that you first visit the Orders API documentation before diving into tax calculations.
To enable dynamic tax calculations for your orders, simply:
After doing those two steps, you can optionally learn how Orders API tax integrations work including support for tax codes and value-added tax (VAT).
Step 1: Create your Taxamo account
If you don’t already have a Taxamo account, create one by registering at the Taxamo Sign-up Page. After creating the account and logging in, you can obtain the URL to use for Orders API tax calculations. To obtain this URL, click Home in the Taxamo dashboard, then click Integrate in the top right corner and select Payment Service Providers. Select the Stripe and scroll to the bottom of the page. Click Generate Stripe Tax Provider URL to get a URL for tax calculations. You will use this URL to activate Taxamo in Stripe.
Step 2: Activate Taxamo in Stripe
To activate Taxamo in your Stripe account:
- Log into your Stripe account and navigate to the Relay settings.
- Choose Live mode under Settings, then click Change tax next to the Taxes setting.
- Choose Provider under Type and Taxamo under Provider.
- Enter your full Taxamo Stripe URL (it should start with https://api.taxamo.com) into the Taxamo URL field in the form. (This is the URL you found on the Taxamo integrations page.)
- Click Update to save your credentials.
Taxamo’s integration has both a live and a test mode. If you want to test Taxamo’s integration in test mode, simply select Test mode in your Orders Settings and enter your Taxamo test mode URL.
As a final step, verify your Stripe account’s legal entity address in the Dashboard’s Account settings page. When calculating taxes, Taxamo uses an Origin address and a Destination address. The Origin address is set to your Stripe account’s legal entity address. The Destination address is set to the shipping address for the order.
Completing these two steps fulfills the activation process. If you would like to learn more about how the integration works, you can read the Orders API tax integration overview.