Connection and Authentication in the Sandbox

To confirm that the connection to the Sandbox environment is correct, verify that the correct x-marketplace-seller-token token has been used to connect to the correct endpoint. You must also configure the test credit card details to authenticate a valid request.

Connection and Authentication in Production

To confirm that connection to the Production environment is correct, verify that the correct x-marketplace-seller-token token has been used to connect to the correct endpoint. You must also configure your credit card details to authenticate a valid request.

For more information, see API Authentication.

EU Tax Liability

Test that transactions for each EU country where you expect Taxamo to have the liability use the expected VAT rate.

Confirmed and Stored Transactions

Test that the transactions are stored and confirmed in the Taxamo system.

Business-to-Business (B2B) Sales

If you process Business-to-Business (B2B) sales, check that the buyer's VAT number is passed through to the Taxamo system and reverse charge is applied if applicable.

IOSS

For transactions that are confirmed with Taxamo and where Taxamo has the liability, the ioss_number field is returned in the response from the API. Ensure that this is received and captured by your system. The IOSS number needs to be provided to the parcel carrier.

Shipping Locations

Test that the correct Ship to and Ship from country is provided in the transaction to Taxamo.

Price Inclusivity and Exclusivity

Test price inclusivity or exclusivity. You may include the VAT in the displayed amount on page on your site or not.

Test one or both of the following as required:

• Test an order that where the price displayed includes the tax.
• Test an order where the price displayed does not include the tax.

Custom IDs

Add your custom_id to the transaction to ensure your order reference is stored along with the transaction information. This ID is intended as a means for you to track the transaction in your system.

Multiple Line Orders - Tax Liability

Note: Multiple-line orders means an order with more than one transaction line.

Check an order with multiple lines that the VAT is added correctly.

Multiple Line Orders - Transaction

Check an order with multiple lines is stored and confirmed in the Taxamo system.

Multiple Line Orders - Invoices

Check the order with multiple lines creates an email with invoice to your test buyer.

Multiple Site Currencies

If your site allows sales in more than one currency, check that the appropriate currency code is sent in the transaction for each code. For more information, see Supported Countries and Currencies.

Currency Codes

Check the price in another currency to ensure the correct currency code is passed.

Invoices or Credit Notes (Test Buyer)

Test that the invoices or credit notes are sent to the test buyer.

Unsupported Countries

Test a country that Taxamo does not support. For example, create a transaction that is shipped to a country outside the EU. Ensure that your system handles these transactions and they are not sent to Taxamo.

Taxamo is not Liable

Create an order where Taxamo is not liable. For example, a consignment of 160 EUR sent to Ireland.

Shipping

Test an order that includes shipping, ensure shipping is added as product_class=S and is taxed appropriately.

Shipping - Order Confirmation and Storage

Check the order with shipping is stored and confirmed in Taxamo system.

Shipping - Line Item Descriptions

Check that the Taxamo invoice includes shipping and the line item description displays as expected.

Product Classification Codes

You use the Product Classification utility to generate codes that you can add to your requests to the Taxamo API. For more information about classifying products, see Product Classification.

To test that this is working, add the product_cn_code code that you generated with the utility to a request and verify that it comes through to Taxamo system.

The codes that you used in your requests are available in the Audit report. For more information, see Audit Report.

Partial Refund

Create a partial refund. Ensure the refund is confirmed in the Taxamo system and a credit note is generated and received by your test buyer.

Full Refund

Create a full refund. Ensure the refund is confirmed in the Taxamo system and a credit note is generated and received by your test buyer.

Error Messages

Create an error to ensure that error messages are handled correctly.

Sandbox Credit Card

Confirm that a Test Credit card has been selected on the billing page on the sandbox.

Production Credit Card

Confirm that you have added your actual credit card details on the billing page in your production account.