Taxamo

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

Validating VAT/GST Numbers

The VAT/GST number in the Taxamo system is called the buyer_tax_number.

If the VAT/GST number has been validated and there are no further validation requirements to determine that the transaction is B2B then the transaction will be marked as tax_deducted where this applies.

Methods for validating the VAT/GST number

The VAT/GST number can be checked by Taxamo in a number of ways depending on the tax region:

  • Only the format of the number is checked against expected format for that region
  • The VAT/GST number supplied is validated against the tax authority system
  • The VAT/GST number supplied is validated against the tax authority system which requires a captcha to be solved to access validation
  • The VAT/GST number supplied is validated against the tax authority system and evidence that the payment is made by a business is also checked (corporate card check is done against the BIN of the credit card)

VAT number format validation

The format of the VAT number is known and the Taxamo system will pattern check this.

This may occur in the case where the tax authority does not provide a means to validate the VAT number against their system or it does not mandate that there is a requirement to validate the number against their system.

Tax authority validation

Taxamo sends a request to the external tax authority system to validate the number.

  • Additional CAPTCHA needs to be solved
    In several countries the validation service has a CAPTCHA that requires the end customer to correctly enter the CAPTCHA text before the number can be validated. Taxamo's API can provide the CAPTCHA for presentation to the customer.

Validating VAT/GST Numbers


Suggested Edits are limited on API Reference Pages

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