Integration

Which items of location evidence do we need to provide?

This is flexible depending on your implementation and what location information you have available. The most common are IP address, billing country, and credit card country, but we generally advise passing all location information and allowing the Taxamo engine to determine the most appropriate pieces to use and the order of precedence. If there is a conflict and we are unable to determine the location, the API will give this response and it can be resolved by prompting the user to declare which of the conflicting locations should be used.

How do I override the values determined by Taxamo?

You can set the tax for a transaction using the informative flag. I have included a screenshot of how this may look per transaction. Marking the transaction as informative means that it will not be added to any settlement report.

How should credit amounts or discounts be applied to transactions?

Taxamo's API does not provide fields for credit amounts or discounts. These calculations should be made prior to calling the API, and then the API will determine the tax and the total amount. If discounts or credits must be displayed on the invoice, this can be accomplished with the use of custom fields.

How do I tell the API to use Inclusive or Exclusive pricing?

Through the API you should be able to achieve this by setting the amount field for exclusive pricing and the total_amount field for inclusive pricing. If amount is provided, Taxamo will add the relevant tax_amount (based on the customer's location) to determine the total_amount. With Inclusive pricing Taxamo will work backwards to calculate the tax_amount (based on the customer location) and amount, using the total_amount offered.

Exclusive pricing example:
{"transaction": {"currency_code": "EUR",
"billing_country_code": "",
"buyer_credit_card_prefix": "",
"buyer_ip":"",
"invoice_address": {"region": ""},
"transaction_lines": [{"custom_id":"1","quantity":1,"amount":100}]}}

Inclusive pricing example:
{"transaction": {"currency_code": "EUR",
"billing_country_code": "",
"buyer_credit_card_prefix": "",
"buyer_ip":"",
"invoice_address": {"region": ""},
"transaction_lines": [{"custom_id":"1","quantity":1,"total_amount":100}]}}

How should the 'Warnings' array in the API be handled?

Warnings are provided when contacting external GST/VAT number validation service and it fails. The result is that the tax is applied to this transaction. In general, it is up to the merchant to decide whether to proceed with the transaction and apply tax or not.