The Taxamo Developer Hub

Welcome to the Taxamo developer hub. You'll find comprehensive guides and documentation to help you start working with Taxamo as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    API Reference

Taxamo Overview

This page will help you get started with taxamo. You'll be up and running in a jiffy!


Taxamo is a service that helps merchants selling digital goods and services to comply with VAT/GST and US sales tax laws.

Taxamo offers merchants two primary services, which can be inter-mixed on a per-country basis:

Taxamo Advantage is our automated tax compliance software. This is a real-time VAT/GST and US sales tax calculation, This service has the following features:

  • Real-time customer location determination
  • VAT/GST and US sales tax calculation
  • Business-to-Business ( B2B - B2B - Business to Business transactions. These can sometimes be VAT exclusive if a reverse charge mechanism is available. ) sales validation (The covers both Tax Exemption Certificates and VAT/GST numbers)
  • Compliant Invoicing
  • Tax reporting applying the correct foreign exchange (FX) rates.

Taxamo Intermediary Plus allows businesses to use the Taxamo technology platform to support the distribution of digital service sales globally. As a platform, Taxamo is liable for VAT/GST obligations on the sale. So, for countries where you use Taxamo Intermediary Plus, your business will not need to register with the local tax authority or file and remit VAT/GST. You won’t need to appoint a tax agent. Taxamo will manage foreign exchange (FX) calculation and take on FX fluctuation exposure.
Taxamo has the liability for filing inaccuracies or any potential late fees or penalties exposure, with the relevant tax authority.

  • This service is not yet available in the United States and Japan.

As Taxamo serves a global market of customers that are at different stages of evolution it is key that we provide flexibility in our service offerings. For each country, you can choose modules which best suit their compliance and overall business requirements.

The core of Taxamo’s service has a comprehensive RESTful API. On top of the API we offer integration libraries provided in several popular languages. We also offer Drop-in UI fields and a customisable Checkout Form that contains the integration with Taxamo to several PSPs, which greatly eases the integration effort. Our documentation covers the primary features, benefits, and requirements of the various options, but we find that every business is different so it is essential to speak with us prior to beginning an integration to ensure that all relevant factors have been considered.

There is also a merchant dashboard that is the central location for configuring settings, viewing data and reports.

In order to integrate Taxamo the following areas need to be considered:

  • Checkout process
  • Subscriptions lifecycle management
  • Invoicing and issuing of credit notes

Checkout Process

B2C Transactions

Countries have different requirements on how to determine whether a transaction should fall under local tax laws or not. The key point to consider is where the customer of the electronic service is located, or in some cases, where they are typically located.

Some countries require the collection of two pieces of non-conflicting evidence while others only require one. Taxamo has developed a real-time tax logic algorithm and evidence hierarchy that manages the effective allocation of the correct tax treatment for every transaction.

Types of Location evidence

The country of the customer must be determined by a number of pieces of evidence. The types of evidence that Taxamo uses can include:

  • IP address
  • Billing address (including the Region and the Zipcode)
  • Payment country (can be derived from the credit card BIN)
  • Payment method country (PayPal user country) and IBAN country
  • VAT/GST registration numbers
  • Self-declaration
  • Other commercially relevant information

B2B Transactions

Where there is a sale to a business customer, typically VAT/GST and US sales tax should not be charged.

VAT/GST Number

When VAT/GST is not collected from a business customer this is what is typically referred to as a reverse charge sale. In order for a transaction to qualify for reverse charge treatment, the business customer must typically provide a VAT/GST number issued by their local tax authority to confirm that they are a business. This number is validated via the Taxamo API.

Depending on the country Taxamo will either validate the number against a local database or check the syntax of the number that is provided, as directed by local requirements.

For a small number of countries, there is an additional requirement of having a self-declaration message that states “By inputting your VAT/GST number you confirm that you are a VAT/GST registered customer”.

Tax Exemption Certificates

Sales tax exemption certificates enable a purchaser to make tax-free purchases that would otherwise be subject to sales tax. The purchaser fills out the certificate and gives it to the seller. Please contact Taxamo for further information on how US tax xemption certificates are managed.

VAT inclusive / exclusive pricing (optional feature)

Taxamo provides a pricing option to display pricing with/without VAT/GST, these options are called universal and dynamic pricing.

With Universal pricing, the merchant can keep the price of their digital good the same across all countries and include the VAT/GST in the price. In this case, the total_amount can be provided to Taxamo; the service will calculate the VAT/GST and return the amount, tax_amount, and total_amount. Note that the default behavior for B2B transactions is different from B2C. When Universal pricing is enabled the B2B transaction will recalculate the total_amount to remove the amount of tax that would have been charged if the transaction had been B2C. This behavior can be overridden via an account setting, if preferred, so that B2B transactions can also have Universal pricing.

Dynamic pricing is where the merchant can price per individual country. They are adding the VAT amount to their list price. Where the pricing is dynamic, the amount is sent to Taxamo and the tax_amount is added to this to give the total_amount.

Intermediary Plus service requirements

Display notes/images dynamically

This requirement applies to the Intermediary Plus service only. Taxamo as an Intermediary is part of the supply chain and facilitates the sale of the service. As a consequence Taxamo becomes liable for the VAT/GST. When Taxamo acts as an Intermediary the Taxamo logo needs to appear on the checkout page. The display of the Taxamo logo is required for tax compliance.

Please see the example below:

Subscriptions lifecycle management

For recurring transactions, a placeholder transaction can be created in Taxamo. This provides the evidence to determine the customer's country so the VAT/GST and the US sales tax rate can be determined for the initial and subsequent transactions. When subsequent transactions occur, the placeholder transaction id can be provided to Taxamo so that the evidence from the initial transaction is used.

If the subscription is updated and there is a change of evidence e.g. customer country/VAT number has changed, this information needs to be provided to Taxamo in order to update the VAT/GST and sales tax calculation.

If there are upgrades / downgrades, Taxamo needs to be notified of the revised charge amount where applicable. These changes are then reflected in appropriate filings and tax reports.


Taxamo’s invoicing module is an optional feature that meets compliance regulations in all countries that we support. For example, India and Belarus require a digital signature to be displayed on every invoice, and in Saudi Arabia the invoice to the end customer must be in Arabic.

Intermediary Plus Service requirements

When a merchant is availing of Taxamo’s Intermediary Plus service there are some additional invoicing requirements for compliance reasons. The following information needs to be on the invoice:

  • Taxamo’s invoice number
  • Taxamo company information
  • Taxamo company address
  • The VAT amount should be displayed in the local currency
  • If the customer is from the UK and the customer paid in USD the VAT amount must be shown in GBP
  • Country-specific additional text (please contact us for further information)

Intermediary Service example transaction flow

As an example, if a merchant is based in the United States and wants to sell a digital good to a customer in Germany for €100 + tax, the transaction will look like this:

The actual sale between Taxamo and the customer for €100 + €19 tax (the VAT rate in Germany is 19%).
An invoice is generated for the customer that references your company and logo, but shows Taxamo as the seller.
The sale between your merchant account and Taxamo for €100, minus the Taxamo commission.
A second invoice is created by Taxamo on behalf of your company and issued to Taxamo via self-billing.

Updated 4 months ago

Taxamo Overview

This page will help you get started with taxamo. You'll be up and running in a jiffy!

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.