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



For some countries, it is required to collect the region code for tax calculation and/or reporting purposes. In this case, a select field should be displayed instead of a text field. Taxamo Drop-in UI can show the select field when appropriate and will populate the options with the correct values.

To enable this, call the TaxamoDropInUI.attachRegion function to attach the component to your HTML elements as shown here:

<div class="col-md-6">
    <div class="form-group bmd-form-group"
        <label class="bmd-label-floating" for="taxamo-region-text-field">Region</label>
        <input id="taxamo-region-text-field" class="form-control"/>
    <div class="form-group bmd-form-group is-filled"
        <label class="bmd-label-floating" for="taxamo-region-select-field">Region</label>
        <select id="taxamo-region-select-field" class="form-control" size="1">

Alternatively, Drop-In UI can create and manage the region fields in the div marked with the data-taxamo-region HTML tag attribute:

<div class="col-md-6" data-taxamo-region></div>

Tax number

The tax number component provides user interface logic for tax number validation, taking into account:

  • Validation messages
  • Tax number name
  • Self-declaration disclaimers
  • Captcha logic and display for tax number validation services which require it (currently: India and Russia)

To enable this call the TaxamoDropInUI.attachBuyerTaxNumberWidget function as shown here:

<div class="col-md-6" style="display:none;" id="tax-number"></div>
// labels can be customised - this one adds : to the end of the label
                              {numberNameLabel: "<span data-taxamo-label='ui_configuration.b2b_current.business_number_name'></span>:"});

Alternatively, Drop-In UI can create and manage the tax number field in the div marked with the data-taxamo-tax-number HTML tag attribute:

<div class="col-md-6" data-taxamo-tax-number style="display:none;"></div>

Updated 2 years ago


Suggested Edits are limited on API Reference Pages

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